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About This Section 


This section contains a new Usability Services command that 
appears after you install the IBM RT PC 3278/79 Emulation 
Licensed Program. This command is: 


EM78 
You should read these pages before using your IBM RT PC 3278/79 
Emulation Licensed Program with the Usability Services command 


interpreter. Insert this section in the Chapter 4 of your Usability 
Services Reference called “Licensed Program Commands.” 
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EM78—Running the 3278/79 Emulation 


EM78 enables you to run the 3278/79 Emulation from Usability 
Services. 


Steps for Running the 3278/79 Emulation 
Display a TOOLS window. 





Select COMMUNICATIONS. Then select OPEN. 


Select EM78. Then select RUN. 


Make the choices and press Do in each pop-up to run the 
command. 


Follow the prompts on the display screen. 


More Detailed Information 
1. To display a TOOLS window: 


e If the window is already open, press the Next Window key 
until the window appears. 


OR 


e Open a window: 


a. Select TOOLS from the Window Types pane of the 
WINDOWS window. The command bar changes to show 
you the commands that you can use with the selected 
window. 


b. Select OPEN from the command bar. A TOOLS window 
appears on the screen. 


2. From the TOOLS window: 
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a. Select COMMUNICATIONS. The command bar changes. 


b. Select OPEN from the command bar. The Communications 


Tools Group appears. 


3. From the Communications Tools Group: 


a. Select EM78. The command bar changes. 


b. Select RUN from the command bar. A pop-up appears that 


contains the choices for EM78. 


4. Make the choices and press Do in each pop-up. Depending on 
your choices, one or more pop-ups may appear. Pressing Do in 
the last remaining pop-up on the screen runs the command with 
your choices. Pressing Quit cancels a pop-up without saving 
your choices. 


The choices are: 


Use Default Profile allows you to choose which keyboard 
profile you want to use. If you select Yes, your profile 
$HOME/emkeys.o or the default profile is used. If you select 
No or the pop-up icon, a pop-up appears that allows you to 
type in the name of the profile you want to use. 


Use Default Subshel! allows you to choose which shell is 
used for the emulation subshell. If you select Yes, $SHELL or 
/bin/sh is used. If you select No or the pop-up icon, a pop-up 
appears that allows you to type in the name of the shell you 
want to use. 


Use Default Save-Screen Files allows you to choose which 
save-screen files you want to use. If you select Yes, 
emsavxxx and emrepxxxx in the $HOME directory are used. 
If you select No or the pop-up icon, a pop-up appears that 
allows you to type in the screen-save file and screen-replace 
file that you want to use. 


5. Follow the prompts on the display screen. See “Running a 
Command in a FILES, TOOLS, or APPLICATIONS Window” in 
Usability Services Reference for details of the prompts. 
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IBM Program License Agreement 


YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE OPENING THIS PACKAGE. 
OPENING THIS PACKAGE INDICATES YOUR ACCEPTANCE OF THESE TERMS AND CONDITIONS. IF YOU DO NOT 
AGREE WITH THEM, YOU SHOULD PROMPTLY RETURN THE PACKAGE UNOPENED AND YOUR MONEY WILL BE 


REFUNDED. 


IBM provides this program and licenses its use in the 
United States and Puerto Rico. Title to the media on which 
this copy of the program is recorded and to the enclosed 
copy of the documentation is transferred to you, but title to 
the copy of the program is retained by IBM or its supplier, 
as applicable. You assume responsibility for the selection of 
the program to achieve your intended results, and for the 
installation, use and results obtained from the program. 


LICENSE 

You may: 

a. use the program on only one machine at any one time 
except as otherwise specified by IBM in the enclosed 
Program Specifications (available for your inspection 
prior to your acceptance of this Agreement); 

b. copy the program into machine readable or printed 
form for backup or modification purposes only in 
support of such use. (Certain programs, however, may 
include mechanisms to limit or inhibit copying. They 
are marked “copy protected”); 

c. modify the program and/or merge it into another 
program for your use on the single machine. (Any 
portion of this program merged into another program 
will continue to be subject to the terms and conditions 
of this Agreement.); and, 

d. transfer the program with a copy of this Agreement to 
another party only if the other party agrees to accept 
from IBM the terms and conditions of this Agreement. 
If you transfer the program, you must at the same time 
either transfer all copies whether in printed or machine- 
readable form to the same party or destroy any copies 
not transferred; this includes all modifications and 
portions of the program contained or merged into other 
programs. IBM will grant a license to such other party 
under this Agreement and the other party will accept 
such license by its initial use of the program. If you 
transfer possession of any copy, modification or merged 
portion of the program, in whole or in part, to another 
party, your license is automatically terminated. 

You must reproduce and include the copyright notice on 
any copy, modification, or portion merged into another 
program. 

You may not reverse assemble or reverse compile the 
program without IBM’s prior written consent. 

You may not use, copy, modify, or transfer the program, or 
any copy, modification or merged portion, in whole or in 
part, except as expressly provided for in this Agreement. 

You may not sublicense, assign, rent or lease this program. 


TERM 

The license is effective until terminated. You may terminate 
it at any other time by destroying the program together with 
all copies, modifications and merged portions in any form. 
It will also terminate upon conditions set forth elsewhere in 
this Agreement or if you fail to comply with any term or 
condition of this Agreement. You agree upon such termi- 
nation to destroy the program together with all copies, mod- 
ifications and merged portions in any form. 


LIMITED WARRANTY AND DISCLAIMER OF 
WARRANTY 

IBM warrants the media on which the program is furnished 
to be free from defects in materials and workmanship under 
normal use for a period of 90 days from the date of IBM’s 
delivery to you as evidenced by a copy of your receipt. 

IBM warrants that each program which is designated by 
IBM as warranted in. its Program Specifications, supplied 
with the program, will conform to such specifications pro- 
vided that the program is properly used on the IBM machine 
for which it was designed. If you believe that there is a 
defect in a warranted program such that it does not meet its 
specifications, you must notify IBM within the warranty 
period set forth in the Program Specifications. 

ALL OTHER PROGRAMS ARE PROVIDED “AS IS” 
WITHOUT WARRANTY OF ANY _ KIND, EITHER 
EXPRESS OR IMPLIED. THE ENTIRE RISK AS TO THE 
QUALITY AND PERFORMANCE OF THE PROGRAM IS 
WITH YOU. SHOULD THE PROGRAM PROVE DEFEC- 
TIVE, YOU (AND NOT IBM OR AN IBM AUTHORIZED 
REPRESENTATIVE) ASSUME THE ENTIRE COST OF 
ALL NECESSARY SERVICING, REPAIR OR COR- 
RECTION. 

IBM does not warrant that the functions contained in any 
program will meet your requirements or that the operation 
of the program will be uninterrupted or error free or that all 
program defects will be corrected. 

THE FOREGOING WARRANTIES ARE IN LIEU OF ALL 
OTHER WARRANTIES, EXPRESS OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS 
FOR A PARTICULAR PURPOSE. 

SOME STATES DO NOT ALLOW THE EXCLUSION OF 
IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION 
MAY NOT APPLY TO YOU. THIS WARRANTY GIVES 
YOU SPECIFIC LEGAL RIGHTS AND YOU MAY ALSO 
ene OTHER RIGHTS WHICH VARY FROM STATE TO 


LIMITATIONS OF REMEDIES 

IBM’s entire liability and your exclusive remedy shall be as 

follows: 

1. es mee to defective media during the warranty 
period: 

a. IBM will replace media not meeting IBM’s “Limited 
Warranty” which is returned to IBM or an IBM 
authorized representative with a copy of your receipt. 

b. In the alternative, if IBM or such IBM authorized rep- 
resentative is unable to deliver replacement media 
which is free of defects in materials and workmanship, 
you may terminate this Agreement by returning the 
program and your money will be refunded. 

2. With respect to warranted programs, in all situations 
involving performance or nonperformance during the 
warranty period, your remedy is (a) the correction by 
IBM of program defects, or (b) if, after repeated efforts, 
IBM is unable to make the program operate as war- 
ranted, you shall be entitled to a refund of the money 
paid or to recover actual damages to the limits set forth 
in this section. 

For any other claim concerning performance or nonper- 
formance by IBM pursuant to, or in any other way 
related to, the warranted programs under this Agree- 
ment, you ‘shall be entitled to recover actual damages to 
the limits set forth in this section. 

IBM’s liability to you for actual damages for any cause 
whatsoever, and regardless of the form of action, shall be 
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limited to the greater of $5,000 or the money paid for the 
program that caused the damages or that is the subject 
matter of, or is directly related to, the cause of action. 

In no event will IBM be liable to you for any lost profits, 
lost savings or other incidental or consequential damages 
arising out of the use of or inability to use such program 
even if IBM or an IBM authorized representative has been 
advised of the possibility of such damages, or for any claim 
by any other party. 

SOME STATES Do NOT ALLOW THE LIMITATION OR 
EXCLUSION OF LIABILITY FOR INCIDENTAL OR CON- 
SEQUENTIAL DAMAGES SO THE ABOVE LIMITATION 
OR EXCLUSION MAY NOT APPLY TO YOU. 


SERVICE 
Service from IBM, if any, will be described in Program Spec- 
ifications or in the statement of service, supplied with the 
program, if there are no Program Specifications. 

IBM may also offer separate services under separate agree- 
ment for a fee. 


GENERAL 
Any attempt to sublicense, assign, rent or lease, or, except 
as expressly provided for in this Agreement, to transfer any 
of the rights, duties or obligations hereunder is void. 

This Agreement will be construed under the Uniform Com- 
mercial Code of the State of New York. 
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Statement of Limited Warranty 


The IBM RT Personal Computer’ 3278/79 Emulation 
Licensed Program, Version 1.1 is warranted to 
conform to this Program Specification when 
properly used in its designated operating 
environments. 


Any other documentation with respect to this 
licensed program is provided for information 
purposes only and does not extend or modify this 
IBM RT PC 3278/79 Emulation Licensed Program, 
Version 1.1 Program Specification. 


The IBM RT PC 3278/79 Emulation Licensed 
Program, Version 1.1 Program Specification may be 
updated from time to time. Such updates may 
constitute a change to these specifications. 


It is possible that this material may contain 
reference to, or information about, IBM products 
(machines and programs), programming, or 
services that are not announced in your country. 
Such references or information must not be 
construed to mean that IBM intends to announce 
such IBM products, programming, or services in 
your country. 


This limited warranty and the 90-day program media 
warranty are contained in the IBM Program License 
Agreement supplied with this product. These 
warranties are available to all licensees of the IBM 
RT PC 3278/79 Emulation Licensed Program, 


Program Specification 


® 
IBM RT Personal Computer 3278/79 Emulation Licensed Program, Version 1.1 


Version 1.1. The limited warranty period is ul 
February 1, 1988, or until six months after writ 
notice by IBM that the warranty period has be: 
terminated, whichever is sooner. 


Statement of Function Warranted 


The IBM RT Personal Computer 3278/79 Emuli 
Licensed Program, Version 1.1 (75X1066) is 
intended to increase the flexibility of the IBM F 
System as a work station for interactive use. 


The. IBM RT PC 3278/79 Emulation now include 
maintenance for International Character Supp: 
keyboard mapping, Usability Services support 
3278/79 Emulation Subshell interface, and 
consistent display support, including the IBM £ 
Megapel Display. 


The highlights of this licensed program are: 


@ Emulation of a subset? of IBM 3278 Display 
Station Model 2 functions 


@e Emulation of a subset of IBM 3279 Color D 
Station Model 2A or Model S2A functions 


@ A subset of base 3270 data-stream suppor 


e File transfer capability between the IBM R 
and IBM host systems with appropriate so 
installed 


1 RT, RT PC, and RT Personal Computer are trademarks of International Business Machines Corporation 


é For details concerning support of subsets, see your IBM marketing representative or authorized IBM 


dealer. 


3 AIX and Advanced Interactive Executive are trademarks of International Business Machines Corporation 


concurrent operation of a host 3278 or 3279 
session and the IBM RT PC AIX® Operating 
System 


Operator control over which of the two sessions 
(the 3278/79 session or the AIX session) is 
displayed and receives keystrokes 


Supports an IBM RT PC host session via one of 
the following: 


— IBM 3174 or 3274 Control Unit 
— IBM 4361 Display/Printer Adapter or Work 
Station Adapter. 


The IBM 3174 or 3274 Control Unit can operate 
in SNA and non-SNA modes when channel 
attached, and in SNA and BSC mode when 
remotely attached. 
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— International Character Support 

— Allow remap of non-escaping keys 

— Preserve user’s choice of shell during 
sub-shell operations 

— Usability Dialog support 


‘cified Operating Environment 


‘thine Requirements 
minimum machine requirements are: 


An IBM RT PC with a display (for example, the 
IBM RT PC Extended Monochrome Graphics 
Display, the IBM RT PC Advanced Color 
Graphics Display, IBM RT PC Advanced 
Monochrome Graphics Display, the IBM 
Personal Computer Display, or an equivalent 
display). 


An IBM Personal Computer 3278/79 Emulation 
Adapter Card (6487844 or 8665789). 


A customer-supplied cable for connection to an 
IBM 3174 or 3274 (type “A”) port or to an IBM 
4361 Display/Printer Adapter or Work Station 
Adapter. 


Note: The number of users on the IBM RT PC AIX 
Operating System Licensed Program, Version 1.1 
(74X9995) or IBM RT PC AIX Operating System 
Licensed Program, Version 2.1 (79X3850), the 
number and type of tasks, and the application 
requirements may expand the requirements beyond 
these minimums. 


Programming Requirements 


The IBM RT PC AIX Operating System Licensed 
Program, Version 1.1 (74X9995) or Version 2.1 
(79X3850) are prerequisite for program execution. 


To perform file transfer functions, the host system 
must have one of the following programs installed: 


@ IBM Host-Supported File Transfer Program 
(IND$FILE) for Virtual Machine/Conversational 
Monitor System (VM/CMS) (5664-281) 


@e IBM Host-Supported File Transfer Program 
(IND$FILE) for Multiple Virtual Systems/Time 
Sharing Options (MVS/TSO) (5665-311) 


Statement of Service 


Program service for valid program-related defects 
in the IBM RT PC 3278/79 Emulation Licensed 
Program, Version 1.1 is available to all IBM RT PC 
3278/79 Emulation Licensed Program, Version 1.1 
licensees until February 1, 1988, or until six months 
after written notice by IBM that the warranty period 
has been terminated, whichever is sooner. 
However, service will be provided only for the 
current update level and for the prior release for 
ninety (90) days following release of the current 
level of update. 


Each licensee’s access to program service is 
determined by the marketing channel through which 
the license was obtained. For example, in the 
United States and Puerto Rico, if the IBM RT PC 
3278/79 Emulation Licensed Program, Version 1.1 
license was obtained through: 


@ An authorized IBM personal computer dealer. 


Requests for program service should be made 
through your dealer. 


@ The IBM North-Central Marketing Division or the 
IBM South-West Marketing Division. 


Requests for program service should be made 
through your company’s service coordinator. 
The service coordinator may contact IBM 
central service through the IBM Support Center 
for assistance in problem determination, 
problem source identification, and problem 
resolution. For further information on service 
coordinators, please contact your IBM 
Marketing Representative. 


The IBM Support Center will operate in callback 
mode between the hours of 7:00 a.m. and 7:00 
p.m. Central Time, Monday through Friday, 
excluding national holidays. 


If the IBM RT PC 3278/79 Emulation Licensed 
Program, Version 1.1 is obtained through transfer of 
license from another party under the conditions of 
the IBM Program License Agreement supplied with 
this product, the new licensee may obtain program 
service through the access arrangement provided 
for the original licensee. 


When a license is transferred, if the original license 
was obtained through the IBM North-Central 
Marketing Division or the IBM South-West Marketing 
Division, the old licensee is responsible for 
contacting their IBM marketing representative to 
make arrangements to transfer service entitlement 
to the new licensee; the new licensee must also 
establish a qualified service coordinator to interface 
to IBM central service. 


IBM does not guarantee service results or that the 
program will be error free, or that all program 
defects will be corrected. 


IBM will respond to a reported defect in an 

unaltered portion of a supported release of the 
licensed program by issuing: defect correction 
information such as correction documentation, 


corrected code, or notice of availability of corre 
code; a restriction; or a bypass. 


Corrected code is provided on a cumulative ba 
on diskettes; no source code is provided. Only 
copy of the corrections with supporting 
documentation will be issued to the licensee, o 
agent of the licensee, reporting the defect. IBN 
authorize various agents such as the IBM Pers: 
Computer dealers and the IBM North-Central 
Marketing Division or IBM South-West Marketir 
Division customer’s service coordinator to mak 
and distribute a copy of the corrections if need 
each IBM RT PC 3278/79 Emulation Licensed 
Program, Version 1.1 licensee which they serv 


IBM will notify authorized IBM Personal Compt 
dealers, IBM marketing and service 
representatives, and IBM North-Central Market 
Division and IBM South-West Marketing Divisio 
customer’s service coordinator if and when an 
update is made available. Program updates cc 
all currently available changes for the licensed 
program. 


Licensees may request available updates to thi 
licensed program, if any, prior to the program 
service termination date. As with defect 
corrections, IBM will authorize various agents : 
as IBM Personal Computer dealers and the IBA 
North-Central Marketing Division and IBM 
South-West Marketing Division customer’s serv 
coordinator to distribute a copy of the update, i 
needed, to each IBM RT PC 3278/79 Emulation 
Licensed Program, Version 1.1 licensee which 
serve. 


The total number of copies of an update distrib! 
to IBM RT PC 3278/79 Emulation Licensed Prog 
Version 1.1 licensees within a customer’s loca’ 
may not exceed the number of copies of the IBI 
PC 3278/79 Emulation Licensed Program, 
Version 1.1 licensed to the customer. 


IBM does not plan to release updates of IBM R™ 
3278/79 Emulation Licensed Program, Version 


e on a routine basis for preventative service 
doses. However, should IBM determine that 
‘e is a general need for a preventative service 
ate, it will be made available to all licensees 
iugh the same process that is utilized to 
ribute general IBM RT PC 3278/79 Emulation 
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Licensed Program, Version 1.1 updates, as 
described above. 


Following the discontinuance of all program 
services, this program will be distributed on an “As 
Is” basis without warranty of any kind either 
express or implied. 


IBM Corporation 

Industry Systems Products 
472 Wheelers Farms Road 
Milford, Connecticut 06460 
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Third Edition (January 1987) 
This is a major revision of, and obsoletes, the second edition of IBM RT PC 3278/79 Emulation, SV21-8032-1. 


This edition applies to Version 1.1.1 of the IBM RT PC 3278/79 Emulation Licensed Program, and to all subsequent releases 
until otherwise indicated in new editions or technical newsletters. Changes are periodically made to the information herein; 
these changes will be reported in technical newsletters or in new editions of this publication. 


References in this publication to IBM products, programs, or services do not imply that IBM intends to make these available in 
all countries in which IBM operates. Any reference to an IBM licensed program in this publication is not intended to state or 
imply that only IBM’s licensed program may be used. Any functionally equivalent program may be used instead. 


International Business Machines Corporation provides this manual "as is,” without warranty of any kind, either 
express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a 
particular purpose. IBM may make improvements and/or changes in the product(s) and/or the program(s) described 
in this manual at any time. 


Products are not stocked at the address given below. Requests for copies of this product and for technical information about 
the system should be made to your authorized IBM RT PC dealer or your IBM marketing representative. 


A reader’s comment form is provided at the back of this publication. If the form has been removed, address comments to IBM 
Corporation, Department 997, 11400 Burnet Road, Austin, Texas 78758. IBM may use or distribute whatever information you 
supply in any way it believes appropriate without incurring any obligation to you. 


© Copyright International Business Machines Corporation 1985, 1986, 1987 





About This Book 


This book provides information about the IBM RT PC 3278/79 Emulation Licensed 
Program. With this product, you can communicate with a host computer, using the IBM 
RT Personal Computer! keyboard and display. The emulation enables you to use the 
functions and programming of the host computer and to transfer files between an IBM 


RT! PC and the host. 


Who Should Read This Book 


This book is primarily for the user of 3278/79 Emulation in U. 8S. English or one of the 
other supported languages. The major tasks for this user are installing and using the 
licensed program to emulate an IBM 3278 or 3279 display station on an IBM RT PC’', and 
transferring files between an IBM RT PC and a host computer. In addition, this user may 
want to modify the keyboard layout and screen modes, and change screen colors on a 
color monitor. 


Readers need a basic understanding of the functions of the IBM RT PC and the IBM 3278 
Display Station or the IBM 3279 Color Display Station. In addition, programmers will find 
it helpful to know about C Language, the Advanced Interactive Executive Operating 
System (AIX?), and the Virtual Resource Manager (VRM). 


1 RT Personal Computer, RT PC, and RT are trademarks of International Business Machines Corporation. 


2 AIX is a trademark of International Business Machines Corporation. 
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How to Use This Book 


To install the IBM RT PC 3278/79 Emulation Licensed Program, read the procedures in 
Appendix A. 


To use 3278/79 Emulation, become familiar with Chapter 1, “About IBM RT PC 3278/79 
Emulation,” Chapter 2, “Using 3278/79 Emulation,” and Chapter 3, “Transferring 
Files.” If an error message appears on the display, consult Appendix B, “Problem 
Determination.” 


To modify the keyboard layout or screen modes or to change screen colors on a color 
monitor, use Chapter 4, “Changing Keyboard and Color Defaults.” 


The appendixes are organized in three sections: (1) Appendixes A and B are for reference 
when you install or get a message from 3278/79 Emulation, (2) Appendix C is for users of 
languages other than English (US), and (3) Appendixes D, E, F, and G are for 
programmers working with 3278/79 Emulation. 


Programmers can learn about the interface to the AIX Operating System and the Virtual 
Resource Manager device drivers in Appendix D, and learn about communication with 
File Transfer through an application program in Appendix E. To see the translation 
between ASCII and EBCDIC during file transfer, consult the tables in Appendixes F and 
G. 


How This Book is Organized 


Individual chapters and appendixes are organized as follows: 

e Chapter 1 provides an overview of the IBM RT PC 3278/79 Emulation Licensed 
Program. Included in this chapter are an overview of 3278/79 Emulation functions, 
the hardware and software requirements, and limitations of the licensed program. 


e Chapter 2 describes how to invoke and use 3278/79 Emulation. Also given is 
information on commands and the default keyboard. 
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Chapter 3 provides information on the file transfer function. 
Chapter 4 tells how to change the default values for the keyboard and color display. 


Appendix A describes IBM RT PC 3278/79 Emulation Licensed Program installation 
procedures. 


Appendix B provides information on problem determination, including error messages, 
their cause, and recommended action. 


Appendix C lists the unsupported, valid, and duplicate RT PC keys for 3278/79 
Emulation in the supported languages. 


Appendix D describes the interface to the AIX Operating System and Virtual Resource 
Manager (VRM) drivers, including the system calls and interrupts. Also included is 
information on the RAS log. 


Appendix E describes the File Transfer Application Program Interface. 


Appendix F contains tables that show the translation between ASCII and EBCDIC 
during file transfer for Version 1.1 of the AIX Operating System. 


Appendix G contains tables that show the translation between ASCII and EBCDIC 
during file transfer for Version 2.1 of the AIX Operating System. 


The Glossary and Index are tools for you to use as you need them. 


A Reader’s Comment Form and Book Evaluation Form are provided at the back of this 
book. Use the Reader’s Comment Form at any time to give IBM information that may 
improve the book. After you become familiar with the book, use the Book Evaluation 

Form to give IBM specific feedback about the book. 
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Related Publications 


The following documents in the IBM RT PC series contain additional information that 
may prove helpful in understanding and using the IBM RT PC 3278/79 Emulation 
Licensed Program. 


v1 


IBM RT PC AIX Operating System Commands Reference lists and describes the AIX 
Operating System commands. 


IBM RT PC AIX Operating System Programming Tools and Interfaces describes the 
programming environment of the AIX Operating System and includes information 
about using the operating system tools to develop, compile, and debug programs. In 
addition, this book describes the operating system services and how to take advantage 
of them in a program. This book also includes a diskette that includes programming 
examples, written in C language, to illustrate using system calls and subroutines in 
short, working programs. (Available optionally) 


IBM RT PC AIX Operating System Technical Reference describes the system calls and 
subroutines that a C programmer uses to write programs. This book also provides 
information about the AIX file system, special files, miscellaneous files, and writing 
device drivers. (Available optionally) 


IBM RT PC Installing and Customizing the AIX Operating System provides 
step-by-step instructions for installing and customizing the AIX Operating System, 
including how to add or delete devices from the system and how to define device 
characteristics. This book also explains how to create, delete, or change AIX and 
non-AIX minidisks. 


IBM RT PC Keyboard Description and Character Reference describes the national 
character and keyboard support for the 101-key, 102-key, and 106-key keyboards, 
including keyboard position codes, keyboard states, control code points, code sequence 
processing, and nonspacing character sequences. 


IBM RT PC Messages Reference lists messages displayed by the IBM RT PC and 
explains how to respond to the messages. 
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IBM RT PC Problem Determination Guide provides instructions for running 
diagnostic routines to locate and identify hardware problems. A problem 
determination guide for software and diskettes containing the IBM RT PC diagnostic 
routines are included. 


IBM RT PC Using and Managing the AIX Operating System describes using AIX 
Operating System commands, working with the file system, and developing shell 
procedures. This book also provides instructions for performing such system 
management tasks as adding and deleting user IDs, creating and mounting file 
systems, backing up the system, and repairing file system damage. 


IBM RT PC Virtual Resource Manager Technical Reference describes the Virtual 
Resource Manager (VRM) routines, how to use the VRM debugger, how to develop 
and install code into the VRM, and defines the interface to the VRM-supplied device 
drivers. This book also describes the Virtual Machine Interface (VMI) between the 
Virtual Resource Manager and the AIX Operating System and provides information 
about process control, memory management, the I/O subsystem, the minidisk manager, 
and device drivers. (Available optionally) 


See IBM RT PC Bibliography and Master Index for order numbers of IBM RT PC 
publications and diskettes. 


For more information on IBM 3278 and IBM 3279 Display Stations, the following 
publications are recommended: 


IBM Personal Computer 3278/79 Emulation Adapter Technical Reference, Part Number 
1502336 


IBM Virtual Machine Facility/370: CMS Command and Macro Reference, GC20-1818 
IBM VM/370 CMS User’s Guide, GC20-1819 

IBM OS/VS2 TSO Command Language Reference, GC28-0646 

IBM OS/VS2 TSO Terminal User’s Guide, GC28-0645. 
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Ordering Additional Copies of This Book 


To order additional copies of this publication (without program diskettes), use either of 
the following sources: 


e To order from your IBM representative, use Order Number SV21-8032. 
e To order from your IBM dealer, use Part Number 75X1064. 


A binder is included with the order. 
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About This Chapter 


This chapter describes the IBM RT PC 3278/79 Emulation Licensed 
Program and its functions, and tells what you need to use this 
product on your RT PC. 
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Overview of 3278/79 Emulation 


The IBM RT PC 3278/79 Emulation Licensed Program enables the 
RT PC to emulate either an IBM 3278 Display Model 2 or an IBM 
3279 Color Display Model 2A or S2A by controlling the display 
screen and keyboard. IBM RT PC 3278/79 Emulation also provides 
a means of transferring files between a host computer and the RT 


PC. 


The IBM Personal Computer 3278/79 Emulation Adapter and a 
customer-supplied cable attach the RT PC system to a control unit. 
The control unit provides communication between the RT PC 
system and the host computer. The host may be at a remote 
location. The 3278/79 Emulation program must be used on the 
console of the RT PC system. Attached terminals cannot be used 
for 3278/79 Emulation. 
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Hardware Requirements 


The following items must be connected to the RT PC system to use 
IBM RT PC 3278/79 Emulation: 


e IBM Personal Computer 3278/79 Emulation Adapter (part 
number 6487844). 


e Customer-supplied cable connection to a control unit. 


The RT PC (using the IBM Personal Computer 3278/79 Emulation 

Adapter) can be attached as a CUT type terminal to any of the 

following: 

e IBM 3174 or IBM 3274 Control Unit, configured for a 3278 
“Model 2 Display Station or 3279 Model 2A or S2A Color Display 


Station with a 3278 Keyboard for one of the supported 
languages. 


e IBM 4361 Processor (via the Display/Printer Adapter). 


e IBM 4361 Processor (via the Work Station Adapter). 
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Software Requirements 


The following software must be installed to use the IBM RT PC 
3278/79 Emulation Licensed Program: 


e The IBM RT PC AIX Operating System Licensed Program, 
Version 1.1 or higher. 


Note: For information on installing and configuring the AIX 
Operating System, refer to Installing and Customizing the AIX 
Operating System. 


e For transferring files, IBM Host-Supported File Transfer 
Program (IND$FILE), installed on the host. 


— For a Virtual Machine/Conversational Monitor System 
(VM/CMS), use program 5664_281*. 


— For Multiple Virtual Systems/Time Sharing Options 
(MVS/TSO), use program 5665_311*. 


Note: See your IBM marketing representative for more detailed 
prerequisite information on the software items marked with an * 
(asterisk). 
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Limitations 


The 3278/79 Emulation program should be used with the RT PC 
default keyboard and keyboard mapping, as shipped. 


The following IBM 3270 base features and functions are not 
supported by the IBM RT PC 3278/79 Emulation Licensed Program. 


Alternate cursor* 

Cursor blink* 

Keyboard click* 

Numeric lock feature 

Security keylock 

Magnetic reader control and accessories 
Displayed screens with more than 1920 characters 
Monocase switch 

Selector light pen 

Video output 

Katakana 

APL/TEXT character set 

Keyboards other than the 87-key (or 88-key Japanese English) 
3278/79 keyboard 

RPQs 

Extended data-stream and associated keys: 
— Programmed symbols 

— Extended highlighting 

— Seven-color 

Structured field and attribute processing 
IBM 3270 diagnostic reset dump 

Explicit partitions 

Graphics escape 

IBM 3274 response time monitor. 


Note: The features marked with an * (asterisk) have defined keys, 
but are not implemented. 
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About This Chapter 


The 3278/79 Emulation program enables an RT PC to emulate an 
IBM 3278 Display Station or a IBM 3279 Color Display Station. 


This chapter describes how to: 


Invoke and leave 3278/79 Emulation. 
Issue emulator commands. 

Use the default keyboard. 

Print a screen. 

Write a screen to a file. 

Use ASCII substitution. 


Interpret status information about your terminal or system. 


Chapter 3 describes file transfer between a host and an RT PC. 


Using 3278/79 Emulation 2-3 


The 3278/79 Emulation Command 


The em78 command format and optional parameters are described 
on the following pages. 


The following information will help you read the syntax diagrams 
in this book. If you want more information on reading syntax 
diagrams, see AIX Operating System Commands Reference. When 
examples are given, refer to the em78 command on page 2-5. 
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Information in green must be typed exactly as it appears. For 
example, when you enter a command, type it exactly as it 
appears at the left of the diagram. 

Information in italics indicates the type of information that you 
must enter. For example, the word file must be replaced with a 
valid file name. The letter n must be replaced with a numeric 
value. 

Required and optional parameters appear after the command 
name. Read from left to right on each line to establish your 
path. Use the following hints: 

— Each time you arrive at a parameter with more than one 


branch, take the branch that contains the value you want to 
use. 

The defaults appear on the top line of each branch. Each 
default path is in bold. You may find default paths any 
place in the diagram where a branch appears. If you do not 
type a value for a parameter, the system uses the default 
value. 

If a box with more than one choice is encased in an arrow, 
you can select as many of the choices as you want. For an 
example of this, see the box containing flags -a and -v on 
page 2-5. 

If a box with more than one choice is headed one of, you 
can select only one item. For an example of this, see the 
box containing display choices a, ac, c, e, p, and x on page 
2-5. 





em78 


Purpose: 
Invokes the 3278/79 emulator. 
Syntax: 


em/8 





1. The emulator searches for a profile until it finds one. 
The search order is: 
e file specified with the —k flag 
e $HOME/emkeys.o 
e default profile shipped with product 


2. The emulator searches for a shell file until it finds one. 
The search order is: 
e file specified with the —e flag 
e@ $SHELL 
e /bin/sh 


Description: 
Flags for em’78 are: 


-? 


This special flag displays the help screen for the em78 command. Do not 
use -? with any other flag. To see the help screen, type: 


em/8 -? 


Using 3278/79 Emulation 2-5 


em78 


-a (display ASCII characters) 


Translates certain ASCII characters for the host so these characters can 
appear on the display. 


Note: After the emulator is invoked, ASCII substitution can be obtained 
with the asciitoggle emulator command if you are using U.S. English. For 
more information, see “Using ASCII Substitution Mode” on page 2-20. 


-v (issue verbose comments) 


The product name appears on the screen. 


-r (write screen image to file) 


Writes the screen image to the designated file when the screenrepl key is 
pressed. Any previous contents of the file are replaced with the current 
screen image. 


The file name must follow the -r. For example: 
-rmyfile 


Any valid file name to which you have write permission can be used. If you 
do not use this option, the emulator will write your screen image to a file 
called $HOME/emrepxxxx. (The xxxx is a variable field randomly 
determined by the emulator in each session.) The first time you press the 
screenrepl key, a message containing the name of the temporary file 
appears on the display. 


A key must be defined for the screenrepl emulator command. When you 
first install 3278/79 Emulation, this key is defined as Ctrl plus Scroll Lock 
in the emdefs.p file. If you want to change the definition of this key, see 
“Changing the Keyboard Layout” on page 4-10. 
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em78 


-Ss (append screen image to file) 
Appends the screen image to the designated file when the screensave key is 
pressed. 


The file name, such as myfile, must follow the -s. For example: 


-smyfile 


Any valid file name to which you have write permission can be used. If you 
do not use this option, the emulator will append your screen image to a file 
called $SHOME/emsavxxxx. (The xxxx is a variable field randomly 
determined by the emulator in each session.) The first time you press the 
screensave key, a message containing the name of the temporary file 
appears on the display. 


A key must be defined for the screensave emulator command. When you 
first install 3278/79 Emulation, this key is already defined as Ctrl plus 
Print Screen in the emdefs.p file. If you want to change the definition of 
this key, see “Changing the Keyboard Layout” on page 4-10. 


-d (use the indicated display) 
The 3278/79 Emulation program no longer uses this flag. If the flag is 
present, no action will result from it. Use the AIX Operating System 
display command to switch displays. If needed, see the AJX Operating 
System Commands Reference. 
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em78 


-k (use key, mode, and color assignments in the specified file) 
Uses the keyboard layout, highlighting mode, and color definitions in the 
specified profile instead of the default values. 


The name of the profile, such as emkeys.o, must follow the -k. For 
example: 


-kemkeys .o 


If you plan to use this file as your default profile, add it to your login 
($HOME) directory so you do not need to use the -k flag each time you 
issue the em78 command. (If you do not know what your login directory is, 
look in your /etc/passwd file; see Using and Managing the AIX Operating 
System for details.) 


If you do not use this flag, the emulator looks for a profile named emkeys.o 
in the directory specified by the $HOME environment variable. If no profile 
is found, the emulator will use the default profile shipped with the 3278/79 
Emulation. See the notes on page 2-5. 


-c (use the specified file as the shell) 
Uses the file you specify with this flag as the shell when the 3278/79 
Emulation shell command is issued. The file must be an executable shell. 


If you do not use this flag, the system looks for a shell name specified by the 


$SHELL environment variable. If no shell is defined by the $SHELL 
environment variable, the system uses /bin/sh. See the notes on page 2-5. 
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Invoking the 3278/79 Emulator 


To invoke 3278/79 Emulation: 

1. Make sure you are logged in to the AIX Operating System at 
the RT PC console. The IBM RT PC 3278/79 Emulation only 
runs on the console, not on attached terminals. 


2. Type em/8 on the command line. 


You can add one or more of the optional parameters described 
on the next pages. 


3. Press the Enter key. 
The 3278/79 screen appears on the display and the keyboard is 


under the control of the emulation. You can now establish a 
communication session with the host. 
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A Simplified Way to Invoke the Emulator 


To avoid typing the em78 command and its flags each time you 
invoke the emulator, you can create a shell script. A shell script is 
a file that contains all the shell commands you need for emulation. 
Once this file is created, you can invoke the emulator by typing the 
name of the file and pressing the Enter key. 


Note: The example shows how to create a file called host. If you 
want to give your file a different name, use that name instead of 
host in the example. 


To use a shell script: 


1. Use a text editor to create a new file. This new file contains 
the shell script itself. The example shows how to create the file 
using the ed editor. Follow the steps exactly, changing the 
information on the em78 line to suit your needs. If you use a 
different text editor, create a file containing only the line that 
begins with em/78. 


Type these lines after the AIX Operating System prompt. 
(Where <Enter> appears in the example, press the Enter key.) 


ed <Enter> 
a <Enter> 
em78 -ssavefile <Enter> 


. <Enter> 
Ww host <Enter> 
q <Enter> 
2. To give the file execute permission, type: 


chmod +x host 


Press the Enter key. 
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3. To run the shell script, type host and press the Enter key. 


Each step in the creation of host is described below: 


ed 


a 


Starts the ed line editor. 


Causes ed to add text to the buffer. (A buffer is a 
special storage area in the computer, used to 
temporarily hold data you are working on.) 


em 78 -ssavefile Enters the text (commands) of the procedure itself. 


. (period) 


w host 


q 


This line must begin with the em78 command, but 
em 78 can be followed by any valid em’78 flags. 


Stops the editor from adding text to the buffer. The 
period must be entered in the first position on a line 
by itself. 


Writes (copies) the text from the buffer into the host 
file. : 


Quits (ends) the editing session. 


The procedure created here allows you to specify several flags by 
entering only a short file name. In this example, whenever you 
enter host, you will automatically invoke the emulator and set the 
screensave file to savefile. 


Notes: 


1. For more information on shell scripts, including more advanced 
topics such as passing flags to the script using shell variables, 
see Using and Managing the AIX Operating System. 

2. You can also invoke the emulator from Usability Services if it 
has been installed. See Usability Services Guide for more 
information. 
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Issuing 3278/79 Emulator Commands 


Several commands provided by the emulator are not traditional 
IBM 3278/79 functions. These emulator commands, their functions, 
and the RT PC default key assignments are described in the chart 
that follows. 


RT PC 
Default 
Command | Function Keys 
asciitoggle | Enters/exits ASCII substitution mode. Hold Ctrl 
This mode is valid only for users with and press T. 
English (US) keyboards. In this mode, 
certain characters are translated for the 
host so these characters can be displayed. 
ASCII substitution produces the same 
result as the -a flag in the em78 command. 
See “Using ASCII Substitution Mode” on 
page 2-20 for more information. 


Figure 2-1 (Part 1 of 2). Emulator Commands and Their Default Keys 





































Hold Ctrl 
and press P. 


Issues a power-on reset for the 3278/79 
Emulation adapter. This is equivalent to 
turning on the power to the IBM 3278/79 
display or switching the normal/test toggle 
switch to normal. 








Hold Ctrl 
and press 


Signals that you want to terminate the 
emulator. As a result of termination, the 
connection to the control unit is reset. 
When the connection is reset, the host 
session may be terminated. 
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screenrep! 


screensave 


Figure 2-1 (Part 2 of 2). 


Function 


Replaces the contents of a file with the 
current screen image (used in conjunction 
with the -r emulator flag). See “Storing 
and Printing Screen Data” on page 2-17 
and “em78” on page 2-5 for more 
information. 


Appends the screen contents to a file (used 
in conjunction with the -s emulator flag). 
See “Storing and Printing Screen Data” on 
page 2-17 and “em78” on page 2-5 for more 
information. 


Suspends the emulator and invokes a 
sub-shell for executing shell commands. 
AIX Operating System commands may be 
executed from the emulator sub-shell. If, 
for example, you want to check a file 
created with the screensave command, 
you must suspend the emulator to see the 


file. 


To return to the emulator from the shell, 
hold Ctrl and press D. 


RT PC 
Default 
Keys 
Hold Ctrl 
and press 
Scroll 
Lock. 


Hold Ctrl 
and press 
Print 
Screen. 


Hold Ctrl 
and press C. 





Emulator Commands and Their Default Keys 
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Leaving the 3278/79 Emulator 


There are two ways to leave the 3278/79 Emulator: 
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If you want to leave the 3278/79 Emulator temporarily to use 
AIX commands, press the key or keys designated for shell in 
your keyboard profile. (If you are using the default profile, 
hold the Ctrl key and press the C key.) 


This suspends the emulator and invokes the shell specified by 
the -c flag, the shell name specified as the $SHELL 
environment variable, or /bin/sh. See note 2 on page 2-5. 


The emulator is not active, but it is still running, and the line 
to the host is still active. Use your normal procedure to exit 
the shell. This puts you back in 3278/79 Emulation. 


OR 


If you want to stop 3278/79 Emulator altogether (perhaps to use 
AIX commands for a longer time), press the key or keys 
designated for quit in your keyboard profile. (If you are using 
the default profile, hold the Ctrl key and press the D key.) 


This terminates the emulator and shuts off the line to the host. 
To use 3278/79 Emulation again, enter em78 with the desired 
flags. 


3278/79 Emulation Default Keyboard 


A file with the mapping for the default emulation keyboard is in 
the profile shipped with the IBM RT PC 3278/79 Emulation 
Licensed Program. 


We recommend that you use the template for the default keyboard, 
provided in the back of this manual, or refer to the picture on the 
next page as you become familiar with the keyboard layout. 


The back of the template provides a blank keyboard for you to use 
if you decide to define your own keyboard layout. 


A key can be pressed alone or in combination with another key. A 
key pressed alone produces the unshifted function. Other functions 
are possible if the Shift (hollow up arrow), the Control (Ctrl), the 
Alternate (Alt), or the Alternate Graphics (AltGr) key is pressed 
and held while another key is pressed. 


The default keyboard on the next page shows unshifted functions 
of the keys. Shifted, control, and alternate functions are listed 
below the keyboard. Note that all the emulator commands are 
control functions. 


The [ (left bracket), | (right bracket), and »* (caret) keys 
can be displayed as different characters, depending on whether you 
are in ASCII or EBCDIC mode. For more information, see “Using 
ASCII Substitution Mode” on page 2-20. 


An alternate keyboard profile also is provided. If you want to use 
the alternate keyboard or modify the default keyboard, refer to the 
information in Chapter 4, “Changing Keyboard and Color 
Defaults.” 


Note: The -, |, and ¢ symbols are only displayed when you are 


not in ASCII substitution mode. See “Using ASCII Substitution 
Mode” on page 2-20 for more information. 
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DEFAULT EMULATOR KEYBOARD for U.S. English 


Attn PF1 | PF2 | PF3 | PF4 PF5 | PF6 | PF7 | PFS PF9 | PF10| PF11 |PF12 Print Clear oc lock | Lock 
cm =| ||| 


nda ace 
Tab — Erase 
te 
_— PPP PERE fe Galeal = 
Shift 4} Ee de 3 Shift = 





For Function For Function 


Fl PF13 

F2 PF14 

F3 PF15 

F4 PF16 

F5 PF17 

F6 PF18 

F7 PF19 

F8 PF20 

F9 PF21 
F10 PF22 
F1l PF23 
F12 PF24 
Print Screen Ident 
Scroll Lock Dev Cncl 
Home Field Mark 
Page Up PA3 


rint Screen Screensave 
croll Lock Screenrepl 
Shell 
Quit 
Power-on reset 
ASCIItoggle 


Cursor Select 
Fast Left 
Fast Right 
End Erase Input 
Page Down Dup 
Scroll Lock Test 
Print Screen Sys Req 
Esc Reset 


++4+++4+++4+ 





++t¢4¢4¢4¢4¢4+4+4+4+4+4+4++4 
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Storing and Printing Screen Data 


This section describes several ways to store and print screen data. 


You can store the contents of a screen by appending the data to an 
existing file or by replacing the current contents of a file with the 
screen data. 


To print a screen, you can save the screen data to a printer device. 
To print a previously stored file, you can use a shell command. 


Replacing Data in a File 
To replace the contents of a file with the data on the-screen: 


1. Invoke the emulator with the em78 command. If you want to 
specify a particular file, use the -r flag followed by the file 
name. 


2. When you view a screen you want to save, press the screenrepl 
key. If you did not specify a file with the -r flag, the emulator 
creates a temporary file called $HOME/emrepxxxx. (The 
system chooses random characters for the xxxx.) The first time 
you press the screenrepl key, a message containing the name 
of the temporary file appears on the screen. 
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Appending Data to a File 

To append the contents of a screen to a file: 

1. Invoke the emulator with the em78 command. If you want to 
specify a particular file, use the -s flag followed by the file 
name. 

2. When you view a screen you want to save, press the 
screensave key. If you did not specify a file with the -s flag, 
the emulator creates a temporary file called 
$HOME/emsavxxxx. (The system chooses random characters 


for the xxxx.) The first time you press the screensave key, a 
message containing the name of the file appears on the screen. 


Replacing and Appending Data in the Same File 


If you want the flexibility of using the same file to append and 
replace data: 


1. Invoke the emulator with the em78 command and use both the 
-r and -s flags. The same file name must follow both flags. 


em78 -rfilename -sfilename 
2. When you view a screen you want to save: 


e Press the screenrepl key to replace the current content of 
the file with the screen data. 


OR 


e Press the screensave key to append the screen data to the 
file. 
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Printing a Screen 


To print a screen immediately, save the screen data to a printer 
device. This suspends emulation until the screen is printed. 


1. 


Invoke the emulator with the em78 command and either the -r 
or the -s flag followed by the file name of the printer. For 
example: 


em/8 -r/dev/|Ipn 


In this example, you would type a number instead of the n (for 
example, -r/dev/1p0). 


When you view a screen you want to print, press the 
screenrepl key if you used -r or the screensave key if you 
used -s. Pressing the screensave or screenrepl key starts the 
printing process. 


Printing a Stored File from the Shell 


Use the following steps to print a file that you previously stored 
with the screensave or screenrepl command. For more 
information on writing screens to a file, see “Invoking the 3278/79 
Emulator” on page 2-9. 


1; 


2. 


Press the shell key to enter the emulation sub-shell. 


When the emshell> prompt appears on the display, type: 


print filename 
Press the Enter key. When the file is on the print queue, the 
emshell> prompt appears on the display again so you can 
issue another command. 


To return to the emulator at this point, hold the Ctrl key and 
press the D key. 
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Using ASCII Substitution Mode 


ASCII substitution mode, which is described in the following 
sections, is only valid if you are using English (US) 3278/79 
Emulation. If you specify -a flag or press Asciitoggle using any 
other language keyboard, nothing will happen. 


You must use an ASCII substitution command if you want to 
display the following four typed characters: 


{ (eft bracket) 

] (nght bracket) 

A (caret) 

! (exclamation point) 


To use ASCII substitution, request one of the following: 


e The asciitoggle emulator command (see “Issuing 3278/79 
Emulator Commands” on page 2-12 for more information) 


OR 


e The -a flag with the em78 command (see “em78” on page 2-5 for 
more information). 


Note: If you type some characters onto the display and then 
repeatedly stop and start ASCII substitution mode, the characters 
on the display may not be the ones you expected. For example, if 
you typea [ with ASCII substitution, stop ASCII substitution and 
then start ASCII substitution again, another character will be 
displayed instead of the [ you typed. 
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ASCII and EBCDIC are two common ways for computers to 
represent characters with numbers. For example, the computer 
might represent a letter B with the numeric value 66. The RT PC 
uses ASCII, but many host computers use EBCDIC. EBCDIC uses 
different numeric values than ASCII. 


Technically speaking, ASCII substitution mode translates the 
characters [ , ] , » , and ! soa host that is receptive to ASCII 
mode can interpret the characters correctly. Without ASCII 
substitution mode, the host interprets each of these four characters 
as an EBCDIC character, and returns a different numeric value to 
the RT PC. This new value produces a different character at your 
display than the character you expected to see. 


The following chart shows the characters that display when the 
em78 command is used with ASCII substitution and without ASCII 
substitution: 






If you This is displayed with This is displayed without 
type this: ASCII substitution: ASCII substitution: 






[ (left bracket) [ | 
] (right bracket) ] ¢ 
= 







© (caret) A 
! (exclamation ! 
point) 





The ! is displayed the same for both ASCII mode (with ASCII 
substitution) and EBCDIC mode (without ASCII substitution). 
However, the ASCII value for ! is still different from the EBCDIC 
value. 
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Operator Information Area 


The following status information may appear on line 25 of the RT 
PC display. This information, generated by the control unit, only 
appears when you are connected to an active control unit. 


The information is grouped into five categories: 


Readiness and System Connection 
Do Not Enter (Input Inhibited) 
Reminders 


Shifts and Modes 


Printer Status. 


The following illustration shows where the different categories 
appear on the status line: 





Readiness and Do Not Enter | Reminders | Shifts and Modes} Printer Status 
System Connection | Input Inhibited) 


The tables on the next few pages explain each of these categories. 
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Readiness and System Connection 


The following table explains the values that can be displayed in 
the Readiness and System Connection area. 


Displayed 
Symbol Name What This Means 
4 










| 4 | Ready —_| The IBM 3274 Control Unit is ready. 
The Display/Printer Adapter is ready. 






The Work Station Adapter is ready 
The IBM 3174 Control Unit is ready 


A Online The control unit is connected to the host 
under rule A. 
Online The control unit is connected to the host 
under rule B. 
My Job Your display station is working with your 
job (application). 
System Your display station is connected to the 
Operator system operator (control program). 
? Unowned Your display station is connected to the host 
system but is not connected to your 
application program or the control program. 


TEST Your display station is in test mode. 
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Do Not Enter (Input Inhibited) 


The following table explains the values that can be displayed in 
the Do Not Enter (Input Inhibited) area. 











































Note: Letters in italics, such as nnn, represent a variable field. 
The system will display numbers instead of the nnn. 

X (<) Terminal Wait Time is required for the host 
system to perform a function. 
Wait. 

x T+ What? The last operation was not 
operation you want is correct, 
then press Reset and try again. 

A <=Q> Go Elsewhere You tried to enter, insert, erase, or 
delete a character when the cursor 
Reset and correct the entry. 

X O> Too Much You tried to insert more data than 

Entered this field can hold. Press Reset 
and correct the entry. 

i. Minus Function The requested function is not 
available. Press Reset. 

X /nnn Machine Check Your System Unit is not working 
defines the type of Machine 
Check. Press Reset to restore 
the problem persists; follow local 


Displayed 
Symbol Name What This Means 
accepted. Check to make sure the 
X System lock The host system locked your 
SYSTEM keyboard. Look for a message. 
Wait or press Reset. 
was in a protected area. Press 
X O#? What Number’? You entered an incorrect printer 
ID number. Press Reset. 
properly. The error number nnn 
your keyboard and continue. If 
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procedures for reporting problems: 





Displayed 
Symbol Name What This Means 


Communication There is a problem with the 
Check communication line between the 


control unit and the host system. 
Program Check 
ee0uien 


The error number nnn defines the 
Printer Busy 

























type of Communication Check. 
Press Reset to restore your 
keyboard and continue. If the 
problem persists, follow local 
procedures for reporting problems. 








The control unit detected a 
programming error in the data it 
received from the host system. 
The error number nnn defines the 
type of Program Check. Press 
Reset to restore your keyboard 
and continue. If the problem 
persists, follow local procedures 
for reporting problems. 














The printer connected to your 
display is busy. If =-#nn is 
displayed in the printer status 
area at the far right of the status 
line, the printer is busy with your 
work. Wait for the print operation 
to finish or press Dev Cncl to 
cancel a pending print operation. 





















This message is the same as 
Printer Busy except more time is 
anticipated before your operation 
is accepted. 


Printer Very 
Busy 




















Printer Not 
Working 


Your printer is not operating 
properly. Press Dev Cncl and 
select another printer. 


Operator You are not authorized to do that 
Unauthorized function. Press Reset. 
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Displayed 
Symbol Name What This Means 


X =<* Operator A message from the control 
Message Not operator was rejected. Press 
Accepted Reset. 
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Reminders 


The following table explains the values that can be displayed in 
the Reminders area. 


Note: Letters in italics, such as nnn, represent a variable field. 
The system will display numbers instead of the nnn. 


Displayed 
Symbol Name What This Means 


— 4% a Communication | The communication link between 
Error your control unit and the host 
Reminder system produces errors. 






Shifts and Modes 


The following table explains the values that can be displayed in 


the Shifts and Modes area. 
Displayed 
Symbol Name What This Means 


Shift Mode Your display station is in Shift 
Mode. 
A Insert Mode Your display station is in Insert 
Mode. To turn off Insert Mode, press 
Reset. 
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Printer Status 


The following table explains the values that can be displayed in 
the Printer Status area. 


Note: Letters in italics (such as nn) represent variable fields. 
The system will display some numbers instead of the nn. 


Displayed 
Symbol Name What This Means 


Assign Printer You should replace the _ — 
(underscores) with the ID of the 
printer you want to use. The two 
numbers you type are displayed in 
place of the underscores. 


—=nn Printer You are authorized to use the printer 
Assignment with ID nn. 
—#nn Printer The printer with ID nn is printing 
Printing your work. 
Printer Failure | The printer with ID nn stopped while 
printing your work. 
a 


- Assignment Press the Ident key 
Pending 


[Bienk | | Printing cannot take place 
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Chapter 3. Transferring Files 


File Transfer 3-1 


CONTENTS 


BE TA TR ns we ek OR 8 OF 4 86 Ke OO Oe CHEE OS WO POS OE 4 EE Ow ee OS 3-3 
Cyverview 0: Fire TTSUSISF 6 nek os ak HERS RE OR KEE PES E EOS EEK LARA OO SOE EO 3-4 
Pile trmerer Comverse so cu 6a & £06 BW eS OM OS HOE EERO Dd Ow Ow BO we ROR Es 3-5 
CET ee) 6 nk eh EE ERED OSA SLEDS HY RASS ES OR Oe wR BO we 3-7 
COTO LO! 2 nd bee nk bth bS oR ROSSA oh ee Re Ke RoR BE Re Ee KS 3-10 
ee ge 2 || ne a ee ee Pe ee ea oe arr ee eer D 3-14 
Be Oe es, xh wad be he ee ada one es WEE Ode DEERE Ee eo eR OE OE ee we 3-17 


8-2. 2278/79 Kmulatian 


About This Chapter 


This chapter tells you how to transfer files between an RT PC with 
an IBM Personal Computer 3278/79 Emulation Adapter and the 
host computer. 
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Overview of File Transfer 


To transfer files between the host and an RT PC, an emulation 
session must be established that is free of other host applications. 
Programs such as editors or file management programs cannot be 
running on the host when you start file transfer. 


Use the following steps to transfer files: 


Ls 


2. 
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Make sure the AIX Operating System prompt displays.! 


Invoke 3278/79 Emulation with the em78 command, and specify 
the flags you want. 


Establish a host session. Be certain that you are logged on 
with the ID to which you want to transfer files. 


Activate the emulation sub-shell with the shell key. (Hold the 
Ctrl key and press the C key, unless you changed the default 
combination). All 3278/79 Emulation file transfer commands 
must be issued from the 3278/79 Emulation sub-shell, regardless 
of whether the file is sent or received. 


Send or receive files as follows: 


e To send a file from RT PC to the host, enter the emsend 
command with the flags you want. 

e To receive a file from the host, enter the emrev command 
with the flags you want. 


When file transfer is complete, use your normal procedures to 
return from the 3278/79 Emulation sub-shell. 


You can get the AIX Operating System prompt from the AIX shell or from 
Usability Services, but not from Coprocessor Services. 


File Transfer Commands 


Formats for the emsend and emrev commands for VM/CMS and 
MVS/TSO are on the following pages. For an explanation of 
syntax diagrams, see “The 3278/79 Emulation Command” on 

page 2-4, or see AIX Operating System Commands Reference. 


As you read the descriptions of the host options, remember that: 


You should replace information in italics with some actual 
values. For example, you should replace the letters n and 1 
with actual numbers. 


You should replace an ellipse (...) with a character string. For 
example, host information parameters for VM/CMS must 
replace the ellipse in -V"...". To append an RT PC file in 


host-readable form to the mayrpt host file of type script and 
default mode, you would type the following: 


-V"mayrpt script (APPEND TEXT" 

Type all punctuation except for the following: 
[ and ] (left and right brackets) 
... (ellipse) 


| (vertical bar) 


Anything inside [ | is optional. For example, if you want to 
include a value of 2 in an option expressed as [,7], type: 


my 


A | between items indicates that only one of the separated items 
can be used. For example, the following means that you can 
type TRACKS or CYLINDERS, but not both: 


TRACKS | CYLINDERS 
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In this book and on the Help screens, the following options are 
shown in capital letters. However, you can use lowercase 
letters if you want. 


ASCII BLKSIZE RECFM 

APPEND CRLF SPACE 

AVBLOCK CYLINDERS TEXT 
LRECL 


If any other options besides those above include capital letters, 
you must type them as capital letters. 


In this book and on the Help screens, the -V and -T options are 


followed by a pair of " (double quote marks). However, you 
can use a pairof ' (single quote marks) instead. For 
example, 


-V"mayrpt script (APPEND TEXT" 
and 
-V'mayrpt script (APPEND TEXT' 


are both valid. However, you cannot mix double quotes and 
single quotes. For example, 


-V'mayrpt script (APPEND TEXT" 


is not valid. 





emsend (VM/CMS) 








Purpose: 
Sends files from an RT PC session to a VM/CMS host session. 
Syntax: 
emsend — 
RECFM F 
RECFM V 
LRECL 80 RECFM V | 
> (+ Vf “y 
APPEND LRECL n RECFM F 


RECFM V 


rext 
RECFM F 


Description: 
Flags for emsend are: 


-? 
This special flag displays the help screen for the emsend command. Do not 
use -? with any other flag. To see the help screen, type: 


emsend -? 
-m (monitor the process) 


Monitors the file transfer process and displays the current sequence number, 
duration, and number of bytes transferred. 
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emsend (VM/CMS) 


-r (regulates TEXT option) 
Allows the TEXT host option, described below, to translate each AIX 
Operating System newline to a line separator at the host, but suppresses 
ASCII to EBCDIC translation. 


-t (time the process) 
Times the file transfer process and displays the duration in seconds. 


-v (issue verbose comments) 
Displays the product name, provides information about other flags, and 
periodically displays information about the file being transferred. 


-f (use file) 
Specifies the RT PC file (path and file name) to be sent. The file may be any 
valid AIX Operating System file. If this parameter is not specified, the 
system uses stdin. (By default, stdin corresponds to a keyboard.) 


-w (wait nnn seconds for host) 
Specifies the maximum amount of time to wait for a host response if the 
transmission stops before it is complete. You may specify the value nnn in 
seconds up to 200. The default is 25 seconds. Also, if you specify a value 
that is not valid, the system uses a value of 25 seconds. 


-V"..." (use host information) 
A required parameter that specifies the host information string for 
VM/CMS. Put the information string inside the " " (quotation marks) to 
replace the ... (ellipse). The required parameters that follow must be 
included. Optional parameters may be included in the string. 


fn 
The VM/CMS file name. This is a required positional parameter. 
The file name must be one to eight characters long. 
ft 
The VM/CMS file type. This is a required positional parameter. 
fm 


The VM/CMS file mode. This is an optional positional parameter; 
the default is a. 
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emsend (VM/CMS) 


You must type an opening parenthesis if you specify any host 
options. These options follow: 

APPEND 
Attaches an RT PC file to the end of a host file. APPEND must be 
specified when fn is the same as an existing host filename, or the file 
being transferred will replace the existing host file. The APPEND 
parameter overrides any values for LRECL and RECFM. 

LRECL n 
Specifies the logical record length of the host file, where n is the 
number of characters. If LRECL is omitted for new files, a default of 
80 is used. If you append or replace a file, LRECL is ignored. For 
variable length records, n is the maximum size the host accepts. If 
you do not send a record of maximum size, LRECL is the length of 
the longest record sent. 

CRLF 
Specifies that carriage return/line feed characters are line separators 
and that they be deleted during file transfer. 

ASCII 
Specifies that an RT PC file be converted from ASCII to EBCDIC 
form during file transfer. The conversion occurs at the host, and the 
host uses the English (US) (ASCII) translation table shown in 
Appendix F or G. 


TEXT 
Converts ASCII characters to EBCDIC, and AIX Operating System 


newline characters to host line-separator characters. This is the 
recommended way to make an ASCII file readable at the host. The 
conversion occurs at the RT PC, and the RT PC uses the English 
(US) (TEXT) translation table shown in Appendix F or G. If you use 
the TEXT option, you do not need to use the ASCII or CRLF options. 
RECFM F|V 
Specifies the record format and characteristics of the host file. For 
the last character, use an F (fixed-length record), or a V 
(variable-length record). If RECFM is omitted for new files, the 
default is F, unless the CRLF or TEXT option is specified (V is then 
the default). When you append or replace a file, RECFM is ignored. 
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emsend (MVS/TSO) 


Purpose: 
Sends files from an RT PC session to a MVS/TSO host session. 
Syntax: 
—w25 
emsend \ —) data_set_name —» 
—wii 





; ( 1 ry ( ) » 
(member_name) / password 


APPEND 


RE CF M(F) Bo gay (80) 
RECFM(U) LRECL (7) 
LRECL (84) 











RECFM(WU) LRECL (7) 
LRECL (84) 
RECFM(V) ——+ 
LRECL (rn) 
TEXT RECFM(F) 5 ~ dee 
RECF M(U) LRECL (/n) 
SPACE (n ) 


j ( AVBLOCK (n) ; 


TRACKS 
CYLINDERS 





1. Required part of data-set name for partitioned data sets. 
2. Required part of data-set name for password protected data sets. 
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emsend (MVS/TSO) 


Description: 
Flags for emsend are: 


-? 
This special flag displays the help screen for the emsend command. Do not 
use -? with any other flag. To see the help screen, type: 


emsend -? 


-m (monitor the process) 
Monitors the file transfer process and displays the current sequence number, 
duration, and number of bytes transferred. 


-r (regulates TEXT option) 
Allows the TEXT host option, described below, to translate each AIX 
Operating System newline to a line separator at the host, but suppresses 
ASCII to EBCDIC translation. 


-t (time the process) 
Times the file transfer process and displays the duration in seconds. 


-v (issue verbose comments) 
Displays the product name, provides information about other flags, and 
periodically displays information about the file being transferred. 


-f (use file) 
Specifies the RT PC file (path and file name) to be sent. The file may be any 
valid AIX Operating System file. If this parameter is not specified, the 
system uses stdin. (By default, stdin corresponds to a keyboard.) 


-w (wait nnn seconds for host) 
Specifies the maximum amount of time to wait for a host response if the 
transmission stops before it is complete. You may specify the value nnn in 
seconds up to 200. The default is 25 seconds. Also, if you specify a value 
that is not valid, the system uses a value of 25 seconds. 
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emsend (MVS/TSO) 


-T"..." (use host information) 
A required parameter that specifies the host information string for 
MVS/TSO. Put the information string inside the " " (quotation marks) to 
replace the ... (ellipse). The required parameters that follow must be 
included. Optional parameters may be included in the string. 


data_set_name 
A required positional parameter (the MVS/TSO file name). 
Quotation marks may surround the combined data set name and 
member name to show that the user ID is not prefixed. 

member_name 
The name of one of the members in the directory of a partitioned data 
set. The data set must exist. 

/password 
Required if password protection was specified for the MVS/TSO data 
set. 

APPEND 
Attaches an RT PC file to the end of a host file. You must specify 
APPEND when data_set_name is the same as an existing host file 
name, or the file being transferred will replace the existing host file. 
The APPEND parameter overrides any values for LRECL and 
RECFM. 

CRLF 
Specifies that carriage return/line feed characters are line separators 
and that they be deleted during file transfer. 

ASCII 
Specifies that an RT PC file be converted from ASCII to EBCDIC 
form during file transfer. The conversion occurs at the host, and the 
host uses the English (US) (ASCII) translation table shown in 
Appendix F or G. 

TEXT 
Converts ASCII characters to EBCDIC, and AIX Operating System 
newline characters to host line-separator characters. This is the 
recommended way to make an ASCII file readable at the host. The 
conversion occurs at the RT PC, and the RT PC uses the English 
(US) (TEXT) translation table shown in Appendix F or G. If you use 
the TEXT option, you do not need to use the ASCII or CRLF options. 
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emsend (MVS/TSO) 


Note: If you specify any of the parameters listed below, you must include 
the open and close parentheses. 


RECFM(F|V|U) 
Specifies the record format and characteristics of the host data set. 
For the last character, use an F (fixed-length record), a V 
(variable-length record), or a U (undefined length record). If RECFM 
is omitted for new files, the default is F, unless the CRLF or TEXT 
option is specified (V is then the default). When you append or 
replace a file, RECFM is ignored. 

LRECL(n) 
Specifies the logical record length of the host file, where n is the 
number of characters. If LRECL is omitted, a default of 80 is used for 
new RECFM(F|U) and 84 for new RECFM(YV) files. If you append or 
replace a file, LRECL is ignored. For variable length records, n is 
the maximum size the host accepts. If you do not send a record of 
maximum size, LRECL is the length of the longest record sent. 

BLKSIZE(n) 
Specifies the block size of the host data set, where n is the length in 
bytes of a data block. If BLKSIZE is omitted for new files, the 
default is LRECL. If you are appending or replacing records, 
BLKSIZE is ignored. 

SPACE(n[,i]) [AVBLOCK(n) |TRACKS|CYLINDERS] 
Specifies the amount of space to be allocated for a new data set. If 
SPACE is used, you may use one of three unit options: 
AVBLOCK(n), TRACKS, or CYLINDERS to specify the n (quantity) 
and the ,i (increment). If none of these is specified, the default is the 
value of BLKSIZE. 
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emrcv (VM/CMS) 


Purpose: 
Receives files from a VM/CMS host session. 
Syntax: 


emrcv 








Description: 
Flags for emrcv are: 


-? 
This special flag displays the help screen for the emrev command. Do not 
use -? with any other flag. To see the help screen, type: 


emrcv -? 
-a (append a file) 
Attaches a host file to the end of an RT PC file. You must specify APPEND 


when -ffile is the same as an existing RT PC file name, or the file being 
transferred will replace the RT PC file. 
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emrcv (VM/CMS) 


-m (monitor the process) 
Monitors the file transfer process and displays the current sequence number, 
duration, and number of bytes transferred. 


-r (regulates TEXT option) 
Allows the TEXT host option, described below, to translate each host 
line-separator to an AIX Operating System newline, but suppresses EBCDIC 
to ASCII translation. 


-t (time the process) 
Times the file transfer process and displays the duration in seconds. 


-v (issue verbose comments) 
Displays the product name, provides information about other flags, and 
periodically displays information about the file being transferred. 


-f (use file) 
Specifies the RT PC file (path and file name) to be received. The file name 
may be any valid AIX Operating System file. If you do not specify this 
parameter, the system uses stdout. (By default, stdout corresponds to a 
display screen.) 


-w (wait nnn seconds for host) 
Specifies the maximum amount of time to wait for a host response if the 
transmission stops before it is complete. You may specify the value nnn in 
seconds up to 200. The default is 25 seconds. Also, if you specify a value 
that is not valid, the system uses a value of 25 seconds. 
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emrev (VM/CMS) 


-V"..." (use host information) 
A required parameter that specifies the host information string for 
VM/CMS. Put the information string inside the " " (quotation marks) to 
replace the ... (ellipse). The required parameters that follow must be 
included. Optional parameters may be included in the string. 


fn 
The VM/CMS file name. This is a required positional parameter. 
The file name can be from one to eight characters long. 

ft 
The VM/CMS file type. This is an optional positional parameter. 
The default is *. 

fm 
The VM/CMS file mode. This is an optional positional parameter. 
The default is *. 

( 


You must type an opening parenthesis if you specify any host 
options. These options follow. 

TEXT 
Converts EBCDIC characters to ASCII, and host line-separator 
characters to AIX Operating System newline characters. This is the 
recommended way to make an EBCDIC file readable at the RT PC. 
The conversion occurs at the RT PC, and the RT PC uses the English 
(US) (TEXT) translation tables shown in Appendix F or G. If you use 
the TEXT option, you do not need to use the ASCII or CRLF options. 

ASCII 
Specifies that a host file be converted from EBCDIC to ASCII form 
during file transfer. The conversion occurs at the host, and the host 
uses the English (US) (ASCII) translation table shown in Appendix F 
or G. 

CRLF 
Specifies that carriage return/line feed characters are line separators 
and that they be inserted during file transfer. 
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emrcv (MVS/TSO) 


Purpose: 
Receives files from a MVS/TSO host session. 
Syntax: 
—w25 
emrecv = ‘data_set_name —> 
—whnn 










(member name) 


1. Required part of data-set name for partitioned data sets. 
2. Required part of data-set name for password protected data sets. 


Description: 
Flags for emrev are: 


-? 
This special flag displays the help screen for the emrev command. Do not 
use -? with any other flag. To see the help screen, type: 


emrcv -? 


-a (append a file) 
Attaches a host file to the end of an RT PC file. You must specify APPEND 
when -ffile is the same as an existing RT PC file name, or the file being 
transferred will replace the RT PC file. 
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-m (monitor the process) 
Monitors the file transfer process and displays the current sequence number, 
duration, and number of bytes transferred. 


-r (regulate TEXT option) 
Allows the TEXT host option, described below, to translate each host 
line-separator to an AIX Operating System newline, but suppresses EBCDIC 
to ASCII translation. 


-t (time the process) 
Times the file transfer process and displays the duration in seconds. 


-v (issue verbose comments) 
Displays the product name, provides information about other flags, and 
periodically displays information about the file being transferred. 


-f (use file) 
Specifies the RT PC file (path and file name) to be received. The file may be 
any valid AIX Operating System file. If you do not specify this parameter, 
the system uses stdout. (By default, stdout corresponds to a display 
screen.) 


-w (wait nnn seconds for host) 
Specifies the maximum amount of time to wait for a host response if the 
transmission stops before it is complete. You may specify the value nnn in 
seconds up to 200. The default is 25 seconds. Also, if you specify a value 
that is not valid, the system uses a value of 25 seconds. 
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emrev (MVS/TSO) 





-T"..." (use host information) 
A required parameter that specifies the host information string for 
MVS/TSO. Put the information string inside the " " (quotation marks) to 
replace the ... (ellipse). The required parameters that follow must be 
included. Optional parameters may be included in the string. 


data_set_name 
A required positional parameter (the MVS/TSO file name). 
Quotation marks may surround the combined data set name and 
member name to show that the user ID is not prefixed. 

member_name 
The name of one of the members in the directory of a partitioned data 
set. The data set must exist. 

/password 
Required if password protection was specified for the MVS/TSO data 
set. 

TEXT 
Converts EBCDIC characters to ASCII, and host line-separator 
characters to AIX Operating System newline characters. This is the 
recommended way to make an EBCDIC file readable at the RT PC. 
The conversion occurs at the RT PC, and the RT PC uses the English 
(US) (TEXT) translation table shown in Appendix F or G. If you use 
the TEXT option, you do not need to use the ASCII or CRLF options. 

ASCII 
Specifies that a host file be converted from EBCDIC to ASCII form 
during file transfer. The conversion occurs at the host, and the host 
uses the English (US) (ASCII) translation table shown in Appendix F 
or G 

CRLF 

Specifies that carriage return/line feed characters are line separators 

and that they be inserted during file transfer. 
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Chapter 4. Changing Keyboard and Color Defaults 
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About This Chapter 


This chapter tells you how to change the keyboard layout, select 
different field attribute modes, and use different colors on a color 
display. 

You can do this two ways: 


e Use the alternate keyboard profile provided with IBM RT PC 
3278/79 Emulation. 


e Modify the default or alternate profile to include the keyboard 
layout, attribute modes, and display colors you want. 


This chapter tells you how to do both, using the emkey command. 
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Using the Alternate Keyboard 


The default profile shipped with IBM RT PC 3278/79 Emulation is 
called emdefs.p. This profile covers both the keyboard and 
display. An alternate profile called emaltdefs.p also is provided. 


Study both keyboard layouts to determine which one better serves 
your needs. The default keyboard is pictured in Chapter 2 (see 
“3278/79 Emulation Default Keyboard” on page 2-15), and the 
alternate keyboard layout is shown below. In addition, both 
keyboard layouts are on templates in the back of this manual. 


Note: The -—, |, and ¢ symbols only display when you are not in 
ASCII substitution mode. 


Alternate Emulator Keyboard Layout for U.S. English 
Field Num Caps Scroll 
Clear PF1 | PF2 | PF3 | PF4 PFS | PF6 | PF7 | PF8 PFQ | PF10 PF12 Print Mark iin mii na 


te ee 
sD PRP PPE PP bok 
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Alternate Emulator Keyboard List for U.S. English 


Press 


Ctrl + Print Screen 
Ctrl + Scroll Lock 
Ctrl + C 
Ctrl + D 
Ctrl + P 
Ctrl + T 


Alt 
Alt 
Alt 
Alt 
Alt 
Alt 
Alt 
Alt 
Alt 
Alt 
Alt 


| 
No) 


1 7 


=) 
on 


ause 
croll Lock 
rint Screen 


comgceeenache 


++++++4+4+4+4+ 
= 


For Function 


Screensave 
Screenrep! 
Shell 

Quit 

Power-on reset 


ASCIltoggle 


Cursor Select 
Fast Left 
Fast Right 
Erase Input 
Attn 

Test 

Sys Req 
Reset 

PA1 

PA2 

PA3 


Fl 

F2 

F3 

F4 

F5 

F6 

F7 

F8 

F9 

F10 

F1l1 

F12 

+ Print Screen 
+ Scroll Lock 


++t+4+4++4++4++4+4+4++4 
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For Function 


PF13 
PF14 
PF15 
PF16 
PF17 
PF18 
PF19 
PF20 
PF21 
PF22 
PF23 
PF24 
Ident 
Dev Cncl 
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If you decide to use the alternate keyboard, do the following: 


i 


2. 


Make sure you have write permission in your current directory. 
Type: 

emkey -i/usr/1lib/em/8/emaltdefs.p 
The default name for your new keyboard profile is emkeys.o in 
your current directory. To use a different name, see the 


description of the emkey command “emkey” on page 4-9. 


Press the Enter key. When the command is completed, the 
following message appears: 


The new keyboard profile, "“emkeys.o", 1S now complete. 


To use the new profile, invoke the 3278/79 emulator with the 
em78 command, adding the -k flag and the file name emkeys.o: 


em/8 -kemkeys.o 


If you want to avoid using the -k flag each time you use the 
emulator, put emkeys.o in your login (SHOME) directory. 


Both the original default and the alternate keyboard definition 
files remain in the /usr/lib/em78 directory for future use. You can 
use either file to create new profiles, as described in the following 


pages. 
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General Steps to Change Default Definitions 


There are four general steps to change default definitions. These 
steps apply to the following types of definitions: 


Keyboard keys 
Mnemonic keys 
Screen colors 


Field attribute modes such as blinking and highlighting. 


All these things are defined in a file: the default definitions file, 
the alternate definitions file, or a version of one of these files you 
have previously edited. To change the definitions, you simply edit 
the appropriate file. 


You can change any or all of these three types of definitions in a 
single editing session, then use emkey once to include all of the 
changes in a new keyboard profile. 


The four general steps are: 


Li 


Copy the default definitions file (/usr/lib/em78/emdefs.p) or 

the alternate definitions file (/usr/lib/em78/emaltdefs.p) to a 
directory in which you have write permission so that you can 
edit it. 


Or, if you have a previously edited version of the definitions file 
and want to retain those changes, make sure you use the edited 
file for the rest of these steps. 


Hdit the definitions file and insert the new keyboard, 


mnemonic, mode, and color values you want. The next sections 
in this chapter tell you how to do this. 
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3. Create a new keyboard profile using the emkey command 
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(described in detail in the next section). To use the default file 
names for both the definitions file and the keyboard profile 
(input and output files), type: 


emkey 
Press the Enter key. 


When the command is completed, the following message 
appears: 


The new keyboard profile, "emkeys.o", is now complete. 


In this example, a definitions file called emdefs.p must exist in 
your current directory when you issue the emkey command. 
The new keyboard profile, emkeys.o, will be located in your 
current directory when the command completes. 


Using the new profile, invoke the 3278/79 emulator with the 
em78 command. Use the -k flag and the file name you gave 
with the -o flag, or -kemkeys.o if you did not use the -o flag. 
For this example, type: 


em/8 -kemkeys.o 


If you want to avoid using the -k flag each time you use the 
emulator, put the new profile in your login (}SHOME) directory. 


emkey 


Purpose: 
Creates a new keyboard profile from a user definitions file. 
Syntax: 


—iemdefs.p —oemkeys.o 
emkey an + > 
—jfile —o file 
Description: 
Flags for emkey are: 


-? 
This special flag displays the help screen for the emkey command. Do not 
use -? with any other flag. To see the help screen, type emkey -?. 


-i (use input definitions file file) 
Specifies the location of the user definitions file to be used. This file may 
be any valid AIX file identifier and should contain em’78 profile information 
(like the /usr/lib/em78/emdefs.p file does). The file may be in any 
directory as long as you have read access to it. 


The default value for this flag is emdefs.p in your current directory. 


-o (write output to file) 
Specifies where to write the new keyboard profile. The file may be any 
valid AIX file identifier, provided you have write permission in the 
directory. You may be working in a directory where you do not have write 
permission if you use the -o flag to specify a directory where you do have 
permission. 


The default value for this flag is emkeys.o in your current directory. 
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Changing the Keyboard Layout 


The default keyboard was introduced under “3278/79 Emulation 
Default Keyboard” on page 2-15. Functions of the keys also are on 
the template provided with the IBM RT PC 3278/79 Emulation 
Licensed Program. 


To create an alternate keyboard, we must refer to the keys in a 
different way. The following pictures of the RT PC keyboard uses 
a number for each key to indicate its position on the keyboard. 


Figure 4-1 shows a schematic representation of the U. S. English 
keyboard. Figure 4-2 on page 4-11 shows a schematic 
representation of the RT PC 106-key Japanese keyboard, and 
Figure 4-3 on page 4-11 shows a schematic representation of the 
RT PC 102-key keyboard for other languages supported by the RT 
PC. 


BRAREOROROROEE BOG Sood 
Boo occ 


P= [5 |+[=[+[[=[=[e[o[ 
5 On ooo 





Figure 4-1. Schematic Representation of the RT PC U.S. English Keyboard 
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Figure 4-2. Schematic Representation of the RT PC 106-Key Japanese Keyboard 
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Figure 4-3. Schematic Representation of the RT PC 102-Key Keyboard. This applies to keyboards for 
all supported languages except U. S. English and Japanese. 
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Since we need to know how the 3278/79 Emulation keys relate to 
the RT PC keys before the key functions can be changed, we also 
must refer to the IBM 3278 and IBM 3279 display keys with 
numbers that represent positions on the keyboard. 


Figure 4-4 shows the IBM 3278/79 keyboard for English (US) and 
all other languages that 3278/79 Emulation supports, except 
Japanese English. Figure 4-5 shows the IBM 3278/79 keyboard for 
Japanese English. 


s+ [sje] 7je}eliols|r2}is| ifs] 6 | 
2 [22] 28] 2] [2s [2720 || 20] se] s2| 38] [80 | 81 | 82 





mie eel 96] 67 | 98) 





Figure 4-4. Schematic Representation of the 87-Key IBM 3278/79 Keyboard 
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Figure 4-5. Schematic Representation of the 88-Key Japanese English IBM 3278/79 Keyboard 
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An example of the default 3278/79 Emulation U.S. English 
keyboard layout is shown in chart form in Figure 4-6 on page 4-14 
(from this example you can create a similar chart for other 
languages). Numbers are used to represent key positions. The 
following notations are used for prefixes to the key position 
numbers: 


k Means that the number is an RT PC key. 
k32_ Means that the number is an IBM 3278/79 key. 


Suffixes show a second key that, when pressed at the same time as 
the named key, produces a different function. Figure 4-6 on 

page 4-14 uses the following notations for suffixes to the key 
position number: 


_s Means the shift key. 

_c Means the control (Ctrl) key. The _c suffix is not valid 
for the IBM 3278/79 keyboard. 

_a Means the alternate (Alt) key. 

_g Means the alternate graphics (AltGr) key. This key is 


not on the U.S. English and Japanese keyboards. The _g 
suffix is not valid for the IBM 3278/79 keyboard. 
No suffix Means only one key is pressed. 


Some characters cannot be represented by a key number (for 
example, non-spacing character sequences) because more than one 
RT PC key must be pressed to generate the character. See JBM 
RT PC Keyboard Description and Character Reference for more 
information about non-spacing character sequences. These key 
sequences have mnemonic representations. See “Using Mnemonic 
Key Names” on page 4-24. 


Study the IBM RT PC 3278/79 Emulation default keyboard (see 
“3278/79 Emulation Default Keyboard” on page 2-15) and your RT 
PC keyboard to select the best key assignments for your purpose. 
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Notes: 


1. If you are using a U.S. English keyboard, you can press either 
Alt key. 

2. The following figure represents the contents of the emdefs.p 
file as it comes on the IBM RT PC 3278/79 Emulation Licensed 
Program diskette. This is what the emdefs.p file looks like if 
no one has used an editor to change that file. 

3. Keys defined but not implemented by 3278/79 Emulation are 
marked with an * (asterisk). 
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Figure 4-6 (Part 1 of 3). Example of English (US) Keyboard Map 
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k121_a k32_37 
k32_38 


k124_¢ screensave save screen image, 
append 

k125_c screenrep! save screen image, 
replace 







Figure 4-6 (Part 2 of 3). Example of English (US) Keyboard Map 
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Figure 4-6 (Part 3 of 3). Example of English (US) Keyboard Map 
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Defining an Alternate Keyboard 
As you define the new keyboard: 


1. Prepare a chart like Figure 4-6 on page 4-14 to guide you in 
creating your own definitions file. 


Warning: You must assign the quit function to another 
key combination if you reassign the Ctrl plus D key 
combination. Otherwise, you will not be able to terminate 
the emulator. 


2. Copy the /usr/lib/em78/emdefs.p file or the 
/usr/lib/em78/emaltdefs.p file to a directory in which you 
have write permission so you can edit it. If you havea 
previously edited version of the definitions file and want to 
retain those changes, use the edited file for the remaining steps. 


3. Edit the definitions file, following the chart you prepared. 

4. Create the new profile, using the emkey command with the 
appropriate flags. See “emkey” on page 4-9 for more 
information on the use of this command. 

Once you have created a new keyboard layout, you can use the 


blank keyboard template (on the back of the keyboard templates 
supplied with this book) to show your personalized layout. 
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IBM 3278/79 Key Names 


The following pages contain the names of all the recognized IBM 
3278/79 keys. Use only these names to assign 3278/79 Emulation 
functions to RT PC keys. 


Figure 4-7 (Part 1 of 3). 
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k32_1 k32_1_s k32_1_a 
k32_2 k32_2_s k32_2_a 
ko23 k32_3_s k32_3_a 
k32_4 k32_4_s k32_4_a 
k32_5 k32_5_s k32_5_a 
k32_6 k32_6_s k32_6_a 
k32_7 k32_7_s k32_7_a 
k32_8 k82_8_s k32_8_a 
k32_9 k32_9_s k32_9_a 
k32_10 k32_10_s k32_10_a 
k32_11 k32_11_s k32_11l_a 
k32_12 k32_12_s k32_12_a 
k32_13 Kaz 14s k32_13_a 
k32_14 k32_14_s k32_14_a 
k32_15 k32_15_s k32_15_a 
k32_16 k32_16_s k32_16_a 
k32_17 k32_17_s k32_17_a 
k32_18 k32_18_s k32_18_a 
k32_19 k32_19_s k32_19_a 
k32_20 k382_20_s k32_20_a 
k32_21 k32_21_s k32_21_a 
k82_22 KkS2. 22.3 k32_22_a 
k32_23 k32_23_s Ko2. 238 
k32_24 k382_24 _s k32_24_a 
k32_25 k52_25_s k32_25_a 
k32_26 k32_26_s k382_26_a 
k32_27 k32_27_s k32_27_a 
k32_28 k32_28_s k32_28_a 
k32_29 k32_29_s k32_29_a 
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k32_30 
k32_31 
k32_32 
k32_33 
k32_34 
k32_35 
k32_36 
k32_37 
k32_38 
k32_39 
k32_40 
k32_41 
k32_42 
k32_43 
k32_44 
k32_45 
k32_46 
k32_47 
k32_48 
k32_49 
k32_50 
k32_51 
k32_51A 
k32_52 
k32_53 
k32_54 
k32_55 
k32_56 
k32_57 
k32_58 
k32_59 
k32_60 
k32_61 
k32_62 
k32_63 


Figure 4-7 (Part 2 of 3). 


k32_30_s 
k32.31_8 
k32_ 32.8 
kS2. 33.5 
k32_34_s 
k82. 35s 
k32_36_s 
k32_37_s 
k32_38_s 
k32_39_s 
k32_40_s 
k32_41_s 
k32_42_s 
k32_43_s 
k32_44_s 
k32_45_s 
k32_46_s 
k32_47_s 
k32_48_s 
k32_49_s 
k32_50_s 
k32_51_s 


k32_51A_s 


k32_52_s 
k32. 53.2 
k32_54_s 
k32_55_s 
k32_56_s 
k32_57_s 
k32_58_s 
k32_59_s 
k32_60_s 
k32_61_s 
k32_62_s 
k32_63_s 
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k32_30_a 
k32_31_a 
ko2_ 324 
k32_33_a 
k32_34_a 
k32_35_a 
k32_36_a 
ka? 37_5 
k32_38_a 
k32_39_a 
k32_40_a 
k32_41_a 
k32_42_a 
k32_43_a 
k32_44_a 
k32_45_a 
k32_46_a 
k32_47_a 
k32_48_a 
k32_49_a 
k32_50_a 
k32_5l_a 


k382_51A_a (see note) 


k32_52_a 
k32_53_a 
k32_54_a 
k32_55_a 
k32_56_a 
k32_57_a 
k32_58_a 
k32_59_a 
k32_60_a 
k32_61_a 
k32_62_a 
k32_63_a 
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Figure 4-7 (Part 3 of 3). 


Note: 


k32_64 
k32_65 
k32_66 
k32_67 
k32_68 
k32_69 
k32_70 
k32_71 
k32_72 
k32_74 
k32_75 
k32_76 
k32_77 
k32_78 
k32_79 
k32_80 
k32_81 
k32_82 
k32_83 
k32_84 
k32_85 
k32_86 
k32_87 
k32_88 


page 4-12. 
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k32_64_s 
k32_65_s 
k32_66_s 
k32_67_s 
k32_68_s 
k32_69_s 
k32_70_s 
k32_71_s 
ks272_8 
k32_74_s 
k32_75_s 
k32_76_s 
KkS2_Ti_s 
k32_78_s 
k32_79_s 
k32_80_s 
k32_81_s 
k32_82_s 
k32_83_s 
k32_84_s 
k32_85_s 
k32_86_s 
k32_87_s 
k32_88_s 


k32_64_a 
k32_65_a 
k32_66_a 
k32_67_a 
k32_68_a 
k32_69_a 
k32_70_a 
ko2_ 714 
k32_72_a 
k32_74_a 
k382_75_a 
k32_76_a 
k32_77_a 
k32_78_a 
k32_79_a 
k32_80_a 
k32_81_a 
k32_82_a 
k32_83_a 
k32_84_a 
k32_85_a 
k32_86_a 
k32_87_a 
k32_88_a 


Names of the IBM 3278/79 Keys 


Only on the Japanese English keyboard. See Figure 4-5 on 


RT PC Key Names for U.S. English 


The following pages contain the names of all the recognized RT PC 
keys for U.S. English. Valid key names for other countries are in 


Appendix C. Use only the names listed to assign 3278/79 
Emulation functions to RT PC keys. 


k1 
k2 
k3 
k4 
k5 
k6 
k7 
k8 
k9 
k10 
k11 
k12 
k13 
k15 
k16 
k17 
k18 
k19 
k20 
k21 
k22 
k23 
k24 
k25 
k26 
k27 
k28 
k29 
k31 


kl1_s 
k2_s 
k8_s 
k4_s 
k5_s 
k6_s 
k7_s 
k8_s 
k9_s 
k10_s 
kli_s 
k12_s 
k13_s 
k15_s 
k16_s 
k17_s 
k18_s 
k19_s 
k20_s 
k21_s 
k22_s 
k23_s 
k24_s 
k25_s 
k26_s 
k27_s 
k28_s 
k29_s 
k31_s 


Figure 4-8 (Part 1 of 3). 


kl1_ce 
k2_¢ 
k3_¢ 
k4_¢ 
k5_c 
k6_c 
k7_c 
k8_c 
k9_c 
k10_c 
kll_e 
k12_c 
k13_c 
k15_c 
k16_c 
k17_c 
k18_c 
k19_c 
k20_c 
k21_c 
k22_¢ 
k23_c 
k24_¢ 
k25_c 
k26_c 
k27_c 
k28_c 
k29_c 
k31_c 
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kl_a 
k2_a 
k3_a 
k4_a 


k6_a 

k7_a 

k8_a 

k9_a 

k10_a 
kll_a 
k12_a 
k13_a 
k15_a 
k16_a 
k17_a 
k18_a 
k19_a 
k20_a 
k21_a 
k22_a 
k23_a 
k24_a 
k25_a 
k26_a 
k27_ 
k28_a 
k29_a 
k31l_a 
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k32 
k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k43 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 
k91 
k92 


k32_s 
k33_5 
k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k43_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 


k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


k91_s 
k92_s 


Figure 4-8 (Part 2 of 3). 
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k32_c 
k33_c 
k34_c 
k35_c 
k36_c 
k37_c 
k38_c 
k39_c 
k40_c 
k41_c 
k43_c¢c 
k46_c 
k47_c 
k48_c¢c 
k49_c 
k50_c 
k5l_c 
k52_¢c 
k53_c¢c 
k54_¢c 
k55_c 
k61_c 


k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 
k84_c¢c 
k85_c 
k86_c 
k89_c 
k90_c 
k91_c 
k92_c¢c 
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k32_a 
k33_a 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k41_a 
k43_a 
k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k61_a 


k75_a 
k76_a 
k79_a 
k80_a 
k81_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 


k93 

k95 

k96 

k97 

k98 

k99 

k100 
k101 
k102 
k103 
k104 
k105 
k106 
k108 
k110 
k112 
k113 
k114 
k115 
k116 
k117 
k118 
k119 
k120 
k121 
k122 
k123 
k124 
k125 
k126 


Figure 4-8 (Part 3 of 3). 


k93_s 

k95_s 

k96_s 

k97_s 

k98_s 

k99_s 

k100_s 
k101_s 
k102_s 
k103_s 
k104_s 
k105_s 
k106_s 
k108_s 
k110_s 
k112_s 
k113_s 
k114_s 
k115_s 
k116_s 
k117_s 
k118_s 
k119_s 
k120_s 
k121_s 
k122_s 
k123_s 
k124_s 
k125_s 
k126_s 


k93_c 

k95_c 

k96_c 

k97_c 

k98_c 

k99_c 

k100_c 
k101_c¢c 
k102_c 
k103_c 
k104_¢ 
k105_¢c 
k106_c 
k108_c 
k110_c 
k112_c 
k113_c 
k114_c 
k115_c 
k116_c 
k117_c 
k118_c 
k119_¢c 
k120_c 
k121_¢ 
k122_c 
k123_c 
k124_c 
k125_c 
k126_c 
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Note: The combination control + alternate + another key is 


not valid. 
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Using Mnemonic Key Names 


When you define RT PC keys using mnemonic key names, prepare 
a chart like the one shown on page 4-25. 


You must relate the mnemonic key name to IBM 3278/79 keys. In 
most cases, you will specify two IBM 3278/79 keys to create the 
character represented by the mnemonic. To specify two IBM 
3278/79 keys, list the first IBM 3278/79 key followed by a blank, a 
plus sign, another blank, and the second IBM 3278/79 key (for 
example, k32_50 + k32_61_s). 


The list below contains all of the mnemonic key names recognized 
by the 3278/79 Emulation program. Use only the names listed to 
assign mnemonic keys. See IBM RT PC Keyboard Description and 
Character Reference for more information on non-spacing keys. 


Mnemonic Key Names 


acute grave circumflex umlaut 

a_acute a_grave a_circumflex a_umlaut 

A_acute A_grave A_circumflex A_umlaut 

e_acute e_grave e_circumflex e_umlaut 

K_acute K_grave E_circumflex E_umlaut 

i_acute i_grave i_circumflex i_umlaut 

I_acute I_grave I_circumflex I_umlaut 

o_acute o_grave o_circumflex o_umlaut 

O_acute O_grave O_circumflex O_umlaut 

u_acute u_grave u_circumflex u_umlaut 

U_acute U_grave U_circumflex U_umlaut 
y—umlaut 
Y_umlaut 

tilde overcircle cedilla 

a_tilde a_overcircle c_cedilla 

A_tilde A_overcircle C_cedilla 

o_tilde 

O_tilde 

n_tilde 

N_tilde 
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Assigning Mnemonic Key Names 


The following example uses the Canadian-French key names and 
numbers. You can create a chart using the key names and 
numbers for your language. 


k32_50 + k32_74 


Removing Key Assignments 







You can remove the assignment for a key or key combination in 
your definitions file with the none definition. For example, if you 
want to assign the shell function to RT PC key k32_c instead of 
k48_c, use the following in the profile: 


k32_c shell /* The control state of key 32 is shell.*/ 
k48_c none /*Remove the previous definition shell. */ 
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Duplicate Keys for U. S. English 


Following is an example (using U.S. English) of the keys and key 
combinations that function as duplicate keys and produce identical 
results. If you are not using the U. 8S. English keyboard, see 
“Duplicate Keys” on page C-55 for the duplicate key listings for 
other supported languages. 


If you assign different IBM 3278/79 functions to duplicate keys, the 
first function assigned applies to each duplicate key. Any other 
assignment is ignored. For example, k2 and k93_s always have the 
same function. If you assign k2 to terminate the emulator, the 
duplicate key k93_s also terminates the emulator. 


Keys shown on the same line below perform the same function: 


k2 and k93_s 

k3 and k98_s 

k4 and k103_s 

k5 and k92_s 

k6 and k97_s 

k7 and k102_s 

k8 and k91_s 

k9 and k96_s 

k9_s and k100, k100_s 
k10 and k101_s 

k11 and k99_s 

k12 and k105, k105_s 
k13_s and k106, k106_s 
k15 and k15_s, k36_c 
k15_c and k126_c, k126_a 
k16 and k24_¢ 

k382_c and k90_c 

k43_a and k108_a 

k43 and k48_s, k43_c, k52_c, k108, k108_s, k108_c 
k54 and k104_s 

k55 and k95, k95_s 

k61 and k61_s, k61_c, k61_a 
k76 and k76_s 

k110 and k27_c 
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Changing Colors for Emulation on a Color 
Display 


The definitions file (emdefs.p, emaltdefs.p, or a file you have 
previously changed) holds information about the colors used for 
emulation on your display. 


You can change colors two ways: 


e Change the foreground and background colors for the four 
color definitions: COLOR1, COLOR2, COLOR3, and COLOR4. 


OR 
e Assign new color definitions to IBM 3278/79 field attributes. 


Note: While you are editing the definitions file to change colors, 
you can change other information, such as the keyboard layout at 
the same time. If you do this, you only need to use the emkey 
command once. 


Changing Foreground and Background Colors 
To change the colors used during emulation: 


1. Edit a keyboard definitions file. This can be the default file 
(emdefs.p), the alternate file (emaltdefs.p), or a file you have 
previously changed. See “General Steps to Change Default 
Definitions” on page 4-7 for more information on these files. 


Inside the file, following the key assignments, there is a section 
with the heading DEFINED COLORS. Using the editor, you can 
change this section to include the color definitions you want. 


If you do not change the definitions file (emdefs.p or 


emaltdefs.p), the section that defines colors looks like the 
following example. 
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KKKEKEKKKKKK KKK KKK KKK KKK KKK KEKE KEKE KKEKEKEKKEKKEKKEKEKKKKKKEEK 


* 
* 


* DEFINED IBM RT PC FOREGROUND 

* COLORS AND BACKGROUND COLORS 

KEKKEKKEKKKEK KEKE KKK KKK KKK KKK KKK KK KKK KKK KK KKK KK KEKE KEKKKEKKKKEKK 
COLOR1 f_cyan + b_black 

COLOR2 f_ltgreen + b_black 

COLOR3 f_red + b_black 

COLOR4 f_white + b_black 

default COLOR1 

Status default 


This means that if you do not change the default file 
(emdefs.p) or the alternate file (emaltdefs.p), the system uses 
colors as follows: 


Default Uses foreground from Uses background from 
COLOR! definition. COLOR] definition. 
Status Uses foreground from Uses background from 
Default definition. Default definition. 
Note that the system uses the default colors when no other 


color definition is provided. Also, the status line is sometimes 
called the operator information area. 







You must define the default and status line colors in terms of 
COLOR1, COLOR2, COLOR3, or COLOR4. For example, if you 
wanted to change the default color to a red foreground on a 
black background, you would change the default entry to 
COLOR3. However, if you wanted to change the default color to 
magenta foreground with yellow background, you would have 
to redefine one of the existing colors — for example, COLOR4 — 
then change the default entry to COLOR4. 
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2. Choose the colors you want to use from the following list of 


names: 
FOREGROUND 
f_black f_gray f_yel low 
f_red f_ltred f_brown 


f_green f_ltgreen f_white 
f_blue f_ltblue f_hiwhite 
f_magenta f_ltmagenta 


f_cyan f_ltcyan 
BACKGROUND 

b_black b_blue 

b_red b_magenta 

b_green b_cyan 


b_yellow  b_white 


Change the definitions file to include the colors you want. Be 
sure to separate each foreground and background color in a 
definition with a + (plus sign). Include a blank space both 
before and after the +. For example: 


COLOR1 f_cyan + b_black 
3. To create the new keyboard profile, use emkey with the 


appropriate flags. See “emkey” on page 4-9 for complete 
information on this command. 
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Redefining the Color of Field Attributes 


The emulator definitions file (emdefs.p, emaltdefs.p, or a file you 
have previously changed) holds information about field attributes. 


The field attributes are combinations of the following: 


Unprotected (u) or protected (p) 

Alphameric (a) or numeric (n) 

Normal intensity (1), intensified (h), or non-display (1) 
Non-detect (x) or detect (d) with a light pen. If you do not have 
a light pen on your system or the host, the system ignores this 
attribute. 


If you change the color definitions in the definitions file, the 
default values for field attributes change as well. All field 
attributes that use COLOR1, for example, will have the new colors. 


If you want to change the color definition for field attributes, 
follow the procedure shown on the next page. 


1. Prepare a chart like Figure 4-9 on page 4-31. Put the 3278/79 
Emulation attributes in the first column, but leave the second 
column blank for now. The following default chart contains all 
of the valid combinations of attributes: 
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1 























Figure 4-9. Default Colors for Field Attributes 


2. Write the new color definitions you want into the second 


column. 


3. Use your new chart to help you edit the definitions file. 


4. Use emkey with the appropriate flags to create the new profile. 


The “bold” is a field attribute mode. 
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Redefining the Mode of Field Attributes 


You can edit the definitions file to change the mode of an attribute 
as well as the color. If you select a mode that your display does 
not support, no change will take place. See the display command 
in the AIX Operating System Commands Reference manual for 
additional information about selection of fonts. 


Four modes may be selected: 


blink 

bold 

revideo (reverse video) 
underline 


To change the mode of an attribute, follow the general procedure 
shown under “Redefining the Color of Field Attributes” on 
page 4-30, but do the following: 


1. As you edit the definitions file, locate the attribute for which 
you want to change the mode. 


2. Place a + (plus sign) after the color definition for this attribute 


and add the name of the mode. A blank space must be used 
before and after the plus sign. For example: 


uald COLOR1 + bold 


You can change the mode of an attribute without changing the 
color definition. 


After you have finished editing the definitions file, create the new 
profile by using the emkey command and the appropriate flags. 
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About This Appendix 


This appendix explains how to install the IBM RT PC 3278/79 
Emulation Licensed Program either from the AIX Operating 
System shell.or from Usability Services. The AIX Operating 
System must be installed before you install 3278/79 Emulation on 
your system. 


Since the installation of 3278/79 Emulation modifies system files, 
builds a new AIX Operating System kernel, and restarts the system, 
the system needs to be as inactive as possible. No applications or 
daemons that have open files should be running during the 
installation. This facilitates a good IPL without unreferenced 
inodes when the system restarts. 


Warning: Since the installation of 3278/79 Emulation 
restarts the system, you should not have processes running 
that cannot be interrupted. 


Installing 3278/79 Emulation A-3 


Locating Your 3278/79 Emulation Diskette 


Remove your 3278/79 Emulation diskette from the plastic envelope in the back of this 
book, as shown in the following diagram. 
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Installing 3278/79 Emulation 


You must be in the AIX shell or Usability Services to install 3278/79 Emulation. 


To install 3278/79 Emulation, use the following steps. If an error message occurs during 
the procedure, see the Messages Reference for details. 


To Install 3278/79 Emulation from Usability Services 


From within Usability Services, do one of the following: 


e Refer to the install command, described in Usability Services Reference. Enter the 
install command and follow the prompts. 


OR 


e Go to the WINDOWS window and select AIX Operating System SHELL from the 
Window Types pane. Select OPEN from the command bar. Then enter the 
installp command and follow the prompts. 


For more information on the prompts, see the section on “More Detailed 


Information” on page A-6, beginning with the prompt displayed after Step 4 on 
page A-7. 


Installing 3278/79 Emulation A-5 


To Install 3278/79 Emulation from the AIX Shell 


1. Make sure the system is quiet. Your processes should be the only processes 
running on the system. 


2. Get into the AIX shell. 
3. Log in as a user in the system group. 
4. After the prompt, type jnsta|jp and press the Enter key. 


5. Follow the prompts to insert the IBM RT PC 3278/79 Emulation Licensed Program 
diskette and install the program. 


6. When installation is complete, the system restarts. Remove the diskette from the 


drive and return it to the plastic envelope in the binder or put the diskette in 
another safe place. 


More Detailed Information 


1. The system must be as inactive as possible before you start installation. This means 
that 


e No other users should be logged in. 
e No background processes should be running. 
e No terminals should be enabled except for the console. 


If you are not sure whether the system is inactive, use one or more of the following 
commands (you may need superuser authority): 
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penable Lists the terminals that are enabled. (Do not enter any flags with this 
command.) 


pdisable Forces users off the system by disabling their terminals. (If you disable 
terminals now, you will need to enable them later.) 


phold Prevents users from logging in. 


ps Shows the currently active processes. These include the names of users 
who are logged in to the system. 


kill Stops active processes. 


Note: The system should remain inactive during the entire installation process (until 
the system restarts). 


Get into the AIX shell. For more information, see Using and Managing the AlX 
Operating System. 


Log in to the system as a user in the system group. If you log in with your own ID, 
you must obtain superuser authority. See Using and Managing the AIX Operating 
System for details. 
Type: 

installp 


Press the Enter key. The following prompt appears: 


000-123 Before you continue, you must make sure there 
is no other activity on the system. You should 
have just restarted the system, and no other 
users should be logged on. Refer to your 
messages reference book for more information. 


Do you want to continue with this command? (y or n): 


If you want to continue, type the letter y and press the Enter key. If you want to stop 
installation and display the system prompt, type the letter n and press the Enter key. 
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6. When Please mount volume 1 on /dev/rfd0 displays, insert the IBM RT PC 3278/79 
Emulation Licensed Program diskette into the diskette drive and follow the prompts 
on your display until the installation is complete and the following message appears: 


The installation process has completed. 
Your operating system will now restart. 


7. Remove the IBM RT PC 3278/79 Emulation Licensed Program diskette from the 
diskette drive. Return the diskette to the plastic envelope in the binder or put it in 
another safe place. 


8. To return to work in the AIX Operating System, log in with your user ID and 
password, then issue AIX commands or re-enter the Usability Services shell. 


You may now begin using 3278/79 Emulation. 


Error Codes in the History File 

If the installation fails, one or more error messages appear on the display and an error 
code is listed in the history file (/usr/lpp/em78/Ipp.hist). Installation error messages 
that begin with numbers are documented in the Messages Reference. 

Record the error code, locate the message in Messages Reference, and perform any 
indicated recovery action. If the problem persists when you try the installation again, 
follow your local procedures for reporting problems. 


Before you try the installation again, move the lIpp.hist.bak file to lpp.hist with the 
following command: 


mv /usr/|lpp/em78/lpp.hist.bak /usr/lpp/em78/lpp.hist 


A-8 3278/79 Emulation 


Appendix B. Problem Determination 
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About This Appendix 


This appendix includes the error log and system messages, both of 
which aid problem determination. Information in the error log and 
in the message descriptions includes the probable cause of each 
error and recommended action for the user to take. 
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Error Log 

If the control unit does not respond within 30 seconds after a keystroke has been sent to 

the adapter, two things happen: 

e The Virtual Resource Manager (VRM) driver sends information to the RAS Error Log 
file. This error log is named /usr/adm/ras/errfile. (For more information about the 
error log, see AIX Operating System Problem Determination Guide.) 

e The system displays message 112-009. 

This condition can be caused by control unit inactivity, adapter failure, or cable failure. 

You are not able to invoke 3278/79 Emulation because a connection has not been made 


between your RT PC terminal and the control unit. 


To correct this problem, make sure the cable is connected to the adapter. If this does not 
help, follow your local procedures for reporting hardware problems. 
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Messages 


This section contains 3278/79 Emulation messages that appear on the display. Emulator 
messages begin with 112 and File Transfer messages begin with 113. Host messages all 
are displayed with number 113-012 and are located after that number in the File Transfer 
section. 


The messages describe error conditions or provide a response to certain commands. Each 
error message description includes the probable cause and recommended action that you 
can take. Technical information, when included, is intended for people who are 
knowledgeable about how the RT PC works. The technical information gives details 
about the problem and technical suggestions for a solution. Using a solution found under 
“Technical Information” may require superuser authority. 


Notes: 


1. Some messages refer you to a second message for further information. The second 
message is not described in this section; look for these messages in Messages Reference. 


2. Text pertaining to the error appears on the display instead of message, xxx, yyy, and 
222. 


3. If you want to keep all messages that relate to RT PC in one place, insert the 
messages pages in tab section 110-119 in Messages Reference. 
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Emulator Messages 


112-001 


112-002 


The emulator cannot reset the default keyboard because the "ioctl" 
system call failed. Please follow your local procedures for reporting 
problems. 


The following message gives more information about the error: message. 
Cause: The emulator stopped as you were trying to leave it. 

Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 
reporting problems. 

Technical Information: An ioctl call tried to return the keyboard to the 


default setting and failed. Try using the stty command to reset the default 
keyboard. See AlX Operating System Commands Reference. 


The emulator cannot run on the terminal you are currently using. 
Please use a supported terminal. 


Cause: You tried to run the emulator on a terminal the emulator does not 
support. 


Action: Try again, using a different terminal. 


Technical Information: The terminal used is not a high-function terminal 
(hft). See "Special Files" in AIX Operating System Technical Reference. 
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112-004 


112-006 


The emulator cannot continue because the "fork" system call failed. 
Please follow your local procedures for reporting problems. 


The following message gives more information about the error: message. 


Cause: You cannot use the emulator at this time since it is unable to take 
control of the screen and the keyboard. 


Action: Wait and try again. If you still cannot invoke the emulator, try to 
locate the message in Messages Reference. You may be able to correct the error 
with the action indicated. If you cannot locate the message or the recommended 
action fails to help, follow your local procedures for reporting problems. 


Technical Information: The emulator cannot fork into its screen handler and 
keyboard handler. If this occurred because there were too many active 
processes, a brief wait may resolve the problem. See "System Calls" in AIX 
Operating System Technical Reference for information about the fork call. 


Press Ctrl-D to exit the emulator, or press Enter to remain in the 
emulator. 


Cause: You pressed the key or key combination defined for quit and are asked 
to confirm or to cancel the request. If you exit from the emulator, the 
connection to the control unit is reset. 


Action: If you want to exit from the emulator, hold the Ctrl key and press the 
D key. If you want to remain in the emulator, press the Enter key. 
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112-008 The emulator cannot continue because the "Iseek" system call cannot 
locate the beginning of the communications buffer. Please follow your 
local procedures for reporting problems. 


The following message gives more information about the error: message. 


Cause: Emulation cannot continue, possibly because the adapter is not 
connected. 


Action: Check to see if the adapter is connected. If it is, run the system 
diagnostics tests described in Problem Determination Guide. 


If the card is not defective, try to invoke the emulator again. If you still 
cannot invoke the emulator, try to locate the message in Messages Reference. 
You may be able to correct the error with the action indicated. 


If the card is defective, if you cannot locate the message, or if the recommended 
action fails to help, follow your local procedures for reporting problems. 
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112-009 


The emulator cannot continue because the "read" system call cannot 
read the communications buffer. Make sure your 3278/79 emulation 
adapter is working properly. 


The following message gives more information about the error: message. 


Cause: Emulation cannot continue, probably because of a hardware problem. 
For example, you could get this message when the control unit doesn’t respond 
within 30 seconds after a keystroke was sent to the adapter. This could mean 
that the adapter is not installed or is defective. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error using the error log or the action from the Messages Reference. 


Make sure the cable is connected to the adapter and to the host port. If you 
still cannot invoke the emulator, look in the /usr/adm/ras/errfile error log for 
information (see “Error Log” on page B-4 of the 3278/79 Emulation manual). If 
the error log does not help, run the system diagnostics tests described in 
Problem Determination Guide. If the card is not defective, try to invoke the 
emulator again. If the card is not found by the diagnostics, check to see that 
the adapter card is installed and seated properly. Try the emulator again. 


If the card is defective, if you cannot locate the message, or if the recommended 
action fails to help, follow your local procedures for reporting problems. 
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112-010 The emulator cannot perform your requested power-on reset because the 
"ioctl" system call failed. Please follow your local procedures for 
reporting problems. 


The following message gives more information about the error: message. 


Cause: You pressed the key or key combination defined for power-on reset 
but the emulator adapter was not reset. 


Action: Try again. If you still cannot reset the emulator adapter, try to locate 
the message in Messages Reference. You may be able to correct the error with 


the action indicated. If you cannot locate the message or the recommended 
action fails to help, follow your local procedures for reporting problems. 


112-011 The emulator cannot continue because the system does not have enough 
available memory. 


Cause: The emulator needed to use system memory, but memory was not 
available. 


Action: Try the emulator again when the system is less busy. If you get this 
message again, do one or more of the following: 


e Check the memory hardware. (See Problem Determination Guide for details.) 

e Try the users command with the change subcommand to change the file 
size allowed for a user. See Using and Managing the AIX Operating System 
for information about users. 


e Follow your local procedures for reporting software problems. 


Technical Information: The malloc subroutine failed, and the system did not 
have enough virtual memory for the emulator to run. 


B-10 3278/79 Emulation 


112-012 


112-013 


The emulator cannot continue because the "ioctl" system call cannot 
specify "no wait". Please follow your local procedures for reporting 
problems. 


The following message gives more information about the error: message. 
Cause: One of the instructions for processing keystrokes was not accepted. 


Action: Try again. If you still cannot invoke the emulator, try to locate the 
message in Messages Reference. You may be able to correct the error with the 
action indicated. If you cannot locate the message or the recommended action 
fails to help, follow your local procedures for reporting problems. 


Technical Information: The emulator tried to specify that a read of the 
communications buffer would occur without waiting for the buffer to change. 
The EMNWAIT ioctl failed. 


The emulator cannot continue because the "ioctl" system call cannot 
specify a "wait". Please follow your local procedures for reporting 
problems. 


The following message gives more information about the error: message. 
Cause: One of the instructions for processing keystrokes was not accepted. 
Action: Try again. If you still cannot invoke the emulator, try to locate the 
message in Messages Reference. You may be able to correct the error with the 
action indicated. If you cannot locate the message or the recommended action 
fails to help, follow your local procedures for reporting problems. 

Technical Information: The emulator tried to specify that a read of the 


communications buffer would not occur until the buffer changed. The 
EMWAIT ioctl failed. 
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112-014 The emulator cannot continue because the "ioctl" system call cannot 
send a keystroke. Please follow your local procedures for reporting 
problems. 


The following message gives more information about the error: message. 
Cause: One of the instructions for processing keystrokes was not accepted. 


Action: Try again. If the problem persists, try to locate the message in 
Messages Reference. You may be able to correct the error with the action 
indicated. If you cannot locate the message or the recommended action fails to 
help, follow your local procedures for reporting problems. 


Technical Information: The emulator tried to send a scan code to the 
adapter. The EMKEY ioctl failed. 


112-015 The emulator cannot continue because the "xxx" file cannot be opened. 
Make sure you used "emkey" to create the file, and that you specified 
the correct file name. 


Cause: The file you specified when you invoked the emulator with the -k flag 
cannot be opened. 


Action: Check to see if the file exists and if you used the correct file name. 
Also check the path name if xxx is not in your current directory. If you used 
emkey to create the file, a message that your new keyboard profile was 
complete should have appeared at that time. 


Try to invoke the emulator again, using the correct file name. If the problem 
continues, check to see if you have “read” permission to the file. 
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112-016 


112-017 


File "xxx" is not a valid profile. The emulator will stop if you requested 
"xxx" with the “-k” flag. Make sure that you used "emkey" to create the 
file, and that you specified the correct file name. 


Cause: You invoked the emulator either with the -k flag and file xxx, or with 
an emkeys.o file in your home directory. In either case, that file does not have 
a valid format. 


Action: If you used the -k flag, check to see if the file exists and if you used 
the correct file name and path. 


If emkey was used to create the file, xxx should have appeared in the specified 
directory at that time. Check the profile to see if it is correct. 


If you did not use the -k flag, the emkeys.o file in your home directory must 
be replaced with a valid file. 


Try to invoke the emulator again. 


The emulator will use the default keyboard layout. If you wish to 
change the keyboard, exit the emulator and try again, specifying “-k” 
and a valid profile name. 


Cause: You invoked the emulator with an emkeys.o file in your home 
directory, but the file is not valid. 


Action: If you are satisfied with the default keyboard, no action is needed. If 
you want to change the keyboard, exit the emulator with the quit key. Then 
do one of the following: 


e Invoke the emulator again, and use the -k flag with a valid file name, or 


e Move the originally requested profile into your home directory, then invoke 
the emulator without the -k flag. 
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112-018 The emulator cannot continue because it cannot read the "xxx" file. 
Make sure that "xxx" is not damaged, and that it was created by 
"emkey". 


The following message gives more information about the error: message. 


Cause: The file you specified when you invoked the emulator with the -k flag 
cannot be read. 


Action: Make sure you specified a file that was created with the emkey 
command. If emkey was used to create the file, xxx should have appeared in 
the directory you specified at that time. If the file is correct, try again. 


If you still cannot invoke the emulator, try to locate the message in Messages 
Reference. You may be able to correct the error with the action indicated. 


If you cannot locate the message or the recommended action fails to help, the 
xxx file may be damaged. Use emkey to create a new copy of xxx from 
emdefs.p or your own definitions profile. Try the emulator again, using the 
new file with the -k flag. 


If these actions do not help, follow your local procedures for reporting 
problems. 
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112-019 The emulator cannot continue because it cannot open the "/dev/tty" 
special device. 


The following message gives more information about the error: message. 
Cause: You invoked the emulator on a display that could not be opened. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. 


If you cannot locate the message or the recommended action fails to help, try 
another display, if one is attached to your RT PC console. 


If you do not have another display attached or if you still cannot start the 
emulator, shut down the AIX Operating System and restart the RT PC, then try 
the emulator again. 


If the preceding procedures do not help, follow your local procedures for 
reporting problems. 


Technical Information: This message could occur because the display is not 
configured in the /etc/master or /etc/system file. Another possible cause is 
that unexpected configuration information was sent to the display via stty or 
some other method. 
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112-020 The emulator cannot continue because the "ioctl" system call cannot get 
information about defaults for your display. 


The following message gives more information about the error: message. 
Cause: The emulator was not able to use this display. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. 


If you cannot locate the message or the recommended action fails to help, try to 
start the emulator using another display attached to your RT PC console. If 
you do not have another display attached to your RT PC or if you still cannot 
start the emulator, follow your local procedures for reporting problems. 


112-021 The emulator cannot continue because the "ioctl" system call cannot get 
information about the default page for your display. 
The following message gives more information about the error: message. 
Cause: The emulator was not able to use this display. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. 


If you cannot locate the message or the recommended action fails to help, try to 
start the emulator using another display attached to your RT PC console. If 
you do not have another display attached to your RT PC or if you still cannot 
start the emulator, follow your local procedures for reporting problems. 
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112-022 


112-023 


The emulator cannot continue because the "ioctl" system call cannot set 
page information for your display. 


The following message gives more information about the error: message. 
Cause: The emulator was not able to use this display. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. 


If you cannot locate the message or the recommended action fails to help, try to 
start the emulator using another display attached to your RT PC console. If 
you do not have another display attached to your RT PC or if you still cannot 
start the emulator, follow your local procedures for reporting problems. 


The emulator cannot continue because the "ioctl" system call cannot set 
raw mode on your display. 


The following message gives more information about the error: message. 
Cause: The emulator was not able to use this display. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. 


If you cannot locate the message or the recommended action fails to help, try to 
start the emulator using another display attached to your RT PC console. If 
you do not have another display attached to your RT PC or if you still cannot 
start the emulator, follow your local procedures for reporting problems. 
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112-024 


112-025 


The emulator cannot continue because it cannot open the "/dev/em78" 
special device. 


The following message gives more information about the error: message. 


Cause: IBM RT PC 3278/79 Emulation may not have been installed properly, 
or the adapter may have been installed incorrectly or never installed. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. 


If you cannot locate the message or the recommended action fails to help, 
install IBM RT PC 3278/79 Emulation again, following the procedures in 
Appendix A of 3278/79 Emulation. If necessary, install or reinstall the adapter. 


If this does not help, run the system diagnostics tests described in Problem 
Determination Guide and follow your local procedures for reporting problems. 


The emulator cannot continue because the "ioctl" system call cannot get 
device data about the 3278/79 emulation adapter. Make sure the 
emulation adapter is working properly. 


The following message gives more information about the error: message. 


Cause: You may have a defective or improperly installed 3278/79 Emulation 
adapter. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. 


If you cannot locate the message or the recommended action fails to help, run 
the system diagnostics tests described in Problem Determination Guide. If 
necessary install the adapter again. 


If the problem continues, follow your local procedures for reporting problems. 
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112-026 


112-027 


The emulator cannot continue because the device type "xxx" of the 
3278/79 emulation adapter is not valid. Please follow your loca! 
procedures for reporting problems. 


Cause: IBM RT PC 3278/79 Emulation may not have been installed properly. 


Action: Install IBM RT PC 3278/79 Emulation, following the procedures in 
Appendix A of 3278/79 Emulation. 


If this does not help, follow your local procedures for reporting problems. 


The emulator cannot continue because the "ioctl" system call cannot 
query ASCII codes and attributes for your display. Please follow your 
local procedures for reporting problems. 


The following message gives more information about the error: message. 


Cause: The emulator cannot get information about your display. You may 
have a defective display. 


Action: Try again to invoke the emulator. If this fails, try to locate the 
message in Messages Reference. You may be able to correct the error with the 
action indicated. 


If you cannot locate the message or the recommended action fails to help, 
follow your local procedures for reporting problems. 
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112-028 The emulator cannot continue because the "semop" system call cannot 
lock the 3278/79 emulation semaphore. Please follow your local 
procedures for reporting problems. 

The following message gives more information about the error: message. 


Cause: The emulator could not continue because of a problem with the 
processes that run the operating system. The problem may be temporary. 


Action: Try again to invoke the emulator. If this fails, try to locate the 

message in Messages Reference. You may be able to correct the error with the 

action indicated. 

If you cannot locate the message or the recommended action fails to help, 

install IBM RT PC 3278/79 Emulation again, following the procedures in 

Appendix A of 3278/79 Emulation. 

If this does not help, follow your local procedures for reporting problems. 
112-029 You can now run shell commands. When you want to return to the 


emulator, press Ctrl-D. 


Cause: You pressed the defined key or key combination to execute shell 
commands. 


Action: When you finish executing the shell commands, press the Ctrl key and 
the D key at the same time to return to the emulator. 
112-030 The emulator cannot continue because it needs more storage. Please 


follow your local procedures for reporting problems. 


Cause: The emulator needs more bytes of storage space to operate. Installing 
more physical memory will not help. 


Action: Please follow your local procedures for reporting problems. 


Technical Information: This message occurs because of an internal 
programming problem involving buffer overflow. 
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112-031 


112-033 


The emulator cannot continue because the "ioctl" system call cannot get 
the correct cursor position data. Please follow your local procedures for 
reporting problems. 


The following message gives more information about the error: message. 


Cause: The 3278/79 Emulation Adapter may have been installed incorrectly or 
never installed. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. 


If you cannot locate the message or the recommended action fails to help, run 
the system diagnostics tests described in Problem Determination Guide. If the 
card is not defective, try to invoke the emulator again. If the card is not found 
by the diagnostics, check to see that the adapter card is installed and seated 
properly. Try the emulator again. 


If the card is defective, if you cannot locate the message, or if the recommended 
action fails to help, follow your local procedures for reporting problems. 


The "emkey" command cannot complete because the "emmakph" file 
cannot be found. Make sure that "emmakph" is installed, and that you 
have execute permission to it. 


Cause: You tried to create a profile with the emkey command, but a program 
file needed to complete the process may be missing. 


Action: Make sure emmakph is installed in the /usr/lib/em78 directory. 
Also make sure you have permission to execute emmakph. Repeat the emkey 
command. 


If you cannot find emmakph, install IBM RT PC 3278/79 Emulation again, 
following the procedures in Appendix A of 3278/79 Emulation. Get execute 
permission, if necessary. Try the emkey command again. 


Technical Information: The emkey command cannot convert your profile 
definitions file to a keyboard profile. 
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112-034 The "emkey" command cannot complete because the "xxx" file cannot be 
found. Make sure "xxx" exists, and that you have read permission to it. 


Cause: You tried to create a profile with the emkey command, but the profile 
definitions file needed to complete the process is not readable or is a directory. 
The xxx file may be missing or not in the proper directory. Or, you may have 
given the name of a directory instead of a file. 


Action: Check to see if xxx exists as a file in the specified directory, and you 
have read permission. If so, repeat the emkey command. 


If the file you specified does not exist, use the default profile or a profile you 
have changed when you reissue the emkey command. 


To use the default profile, make sure the emdefs.p file is in the library or 
install IBM RT PC 3278/79 Emulation again, following the procedures in 
Appendix A of 3278/79 Emulation. Get read permission, if necessary. Try the 
emkey command again. 


To use a profile you have changed, copy xxx from your backup diskette or 
recreate your definitions from the emdefs.p file. Try the emkey command 
again. 


Technical Information: The emkey command cannot convert your profile 
definitions file to a keyboard profile. 
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112-035 


112-037 


112-038 


The "emkey" command cannot complete because one or more required 
files cannot be found. Make sure 3278/79 Emulation is properly installed. 


Cause: You tried to create a new profile with the emkey command, but files 
needed to complete the process are missing. 


Action: Check to see if the IBM RT PC 3278/79 Emulation is installed. To do 
this, look in the /usr/Ipp directory for a directory called em78. 


If the em78 directory is there, repeat the emkey command. If not, install IBM 
RT PC 3278/79 Emulation again, following the procedures in Appendix A of 
3278/79 Emulation. 


The "emkey" command cannot complete because the "emdefs.c" file is 
damaged. Please install 3278/79 Emulation again. 


Cause: You tried to create a new profile with the emkey command but the 
emdefs.c file is not in a useable form. 


Action: Install IBM RT PC 3278/79 Emulation again, following the procedures 
in Appendix A of 3278/79 Emulation. 


The "emkey" command cannot complete because the "emdefs.c" file 
cannot be found. Make sure "emdefs.c" is installed, and that you have 
read permission to it. 


Cause: You tried to create a new profile with the emkey command, but a file 
needed to complete the process was not found. 


Action: Make sure the emdefs.c file is installed in the /usr/lib/em78 
directory and you have permission to read it. Repeat the emkey command. 


If emdefs.c is missing or the problem persists, install IBM RT PC 3278/79 
Emulation again, following the procedures in Appendix A of 3278/79 Emulation. 
Try the emkey command again. 


Technical Information: The emkey command cannot find the emdefs.c file, 
so it cannot compile it. 
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112-0389 The "emkey" command cannot complete because it needs the "xxx" file, 
but "xxx" cannot be opened. Make sure the file exists, and that you have 
read permission to it. 


The following message gives more information about the error: message. 


Cause: You tried to create a new profile with the emkey command, but the 
profile needed to complete the process was not found. 


Action: Make sure the xxx profile exists. If the profile is not in your current 
directory, make sure you specified the path correctly. Check to see if you have 
permission to read xxx. Repeat the emkey command. 


If the command still fails, try installing IBM RT PC 3278/79 Emulation again, 
following the procedures in Appendix A of 3278/79 Emulation. 


Technical Information: The emmakph utility cannot open the xxx profile 
definitions file. 


112-040 The "emkey" command cannot complete because the "emdefs.h" file 
cannot be created. Make sure that you have write permission in the 
"/tmp" directory. 


The following message gives more information about the error: message. 


Cause: You tried to create a new profile with the emkey command, but a file 
needed to complete the process cannot be created. 


Action: Make sure you have write permission in the /tmp directory. Repeat 
the emkey command. 


If the problem continues, try to locate the message in Messages Reference. You 
may be able to correct the error with the action indicated. If you cannot locate 
the message or the recommended action fails to help, follow your local 
procedures for reporting problems. 
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112-041 


112-042 


In the "xxx" file, the entry 

yyy . 

is not correct. The "emkey" command will continue without including 
this entry in the new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: You tried to create a new profile with the emkey command, but a line 
in the profile file is not correct. 


Action: If the omitted definition is not essential, no action is needed. If the 
definition is essential, correct the information in the xxx file, and repeat the 
emkey command. 


The "emkey" command cannot complete because the "xxx" cannot write 
to the new keyboard profile. If you used the "-o" flag to specify an 
output file, make sure you have write permission in the last directory in 
the output path. If you did not use the "-o" flag, make sure you have 
write permission in your current directory. 


The following message gives more information about the error: message. 


Cause: xxx is either the write system call or the mv command. You tried to 
create a new profile with the emkey command, but you may not have had the 
required permission, or the file you specified with the -o flag may be a 
directory. 


Action: Check to see if you have write permission in your current directory or 
the directory you specified with the -o flag. Make sure you specified a 
definitions profile, not a directory. Repeat the emkey command. 


If the problem continues, try to locate the message in Messages Reference. You 
may be able to correct the error with the action indicated. If you cannot locate 
the message or the recommended action fails to help, follow your local 
procedures for reporting problems. 
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112-043 In the "xxx" file, the "yyy" definition is already assigned. The "emkey" 
command will continue without including this entry in the new keyboard 
profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: Your profile file has more than one definition for the key, color, or 
attribute noted. 


Action: Edit the xxx file so that yyy is defined only once, and try emkey 
again. 

112-044 The "emkey" command cannot complete because the "strcat" subroutine 
failed. Please follow your local procedures for reporting problems. 


The following message gives more information about the error: message. 


Cause: You tried to create a new profile with the emkey command, but a 
needed subroutine cannot be completed. 


Action: Repeat the emkey command. 


If the problem continues, try to locate the message in Messages Reference. You 
may be able to correct the error with the action indicated. If you cannot locate 
the message or the recommended action fails to help, follow your local 
procedures for reporting problems. 


Technical Information: A strcat command in the utility called by emkey 


failed. For more information, refer to the string subroutines in AIX Operating 
System Technical Reference. 
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112-045 


112-046 


The definition in the line 

XXX 

needs a corresponding 3278/79 key or local function. The "emkey" 
command will continue without including this entry in the new keyboard 
profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: Your profile contains an RT PC key with no 3278/79 key or local 
function. 


Action: If the key redefinition is not essential, no action is needed. If the key 


redefinition is essential, add a 3278/79 key or local function to the entry in the 
xxx file. Try again. 


In the "xxx" file, "yyy" is not a valid RT PC key name. The "emkey" 
command will continue without including this entry in the new keyboard 
profile. 

To include this entry, correct the "xxx" file and try "emkey" again. 
Cause: Your profile contains an invalid RT PC key name. 

Action: If the key redefinition is not essential, no action is needed. If the key 


redefinition is essential, use a valid RT PC key name in the entry in the xxx 
file. Try again. 
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112-047. Inthe "xxx" file, “yyy" is not a valid 3278/79 key name or local function. 
The "emkey" command will continue without including this entry in the 
new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: Your profile contains a valid RT PC key name, but a 3278/79 key name 
or local function is not valid. 


Action: If the key redefinition is not essential, no action is needed. If the key 
redefinition is essential, use a valid key name or function in the yyy entry in 
the xxx file. Try again. 


112-048 The background color, foreground color, or both are missing from 
LX% 
in the "yyy" file. The "emkey" command will continue without including 
this entry in the new keyboard profile. 


To include this entry, correct the "yyy" file and try "emkey" again. 


Cause: A color definition in the profile does not have both a foreground and a 
background color. 


Action: If the redefinition of the color is not essential, no action is needed. If 


the redefinition is essential, include a foreground and background color in the 
color definition. Try again. 
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112-049 


112-050 


112-051 


In the "xxx" file, the first color in the line 


must be followed by a "+" sign. The "emkey" command will continue 
without including this entry in the new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: A color definition in the profile does not have a + (plus sign) between 
the foreground and background color. 


Action: If the redefinition of the color is not essential, no action is needed. If 
the redefinition is essential, include a blank space, a + (plus sign), and another 
blank space between the foreground and background color. Try again. 


The emulator cannot continue because the "/etc/locks/em78" file cannot 
be created. 


Cause: You tried to invoke the emulator when it was in use, or the file still 
exists from a previous emulation session. 


Action: Wait and try again. If you still cannot invoke the emulator, run ps -e 
to see whether the emulator is being used. (If the emulator is active, em/8 will 
appear in the list of active processes.) If the emulator is not being used, obtain 
permission, if necessary, and delete /etc/locks/em78. Try again. 


In the "xxx" file, the "+" sign in the line 


mo 
must be followed by a foreground or background color. The "emkey" 


command will continue without including this entry in the new keyboard 
profile. 


To include this entry, correct the "yyy" file and try "emkey" again. 


Cause: A color definition in the profile contains one color and a + (plus sign) 
but does not have a second color. 


Action: If the redefinition of the color is not essential, no action is needed. If 
the redefinition is essential, include a foreground or a background color after 
the + (plus sign). Include one blank space before and one blank space after 
the sign. Try again. 
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112-052 


112-053 


112-054 


In the "xxx" file, "yyy" in the line 

zzz 

is not a valid foreground or background color. The "emkey" command 
will continue without including this entry in the new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: A color definition in the profile contains a color that is not a valid 
foreground or background color. 


Action: If the redefinition of the color is not essential, no action is needed. If 
the redefinition is essential, include a valid foreground or background color. 
Try again. 


In the "xxx" file, the value "yyy" is not in a correct position, or is nota 
valid color or mode. The "emkey" command will continue without 
including this entry in the new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 
Cause: A definition in the profile uses the word yyy incorrectly. 


Action: If the redefinition is not essential, no action is needed. If the 
redefinition is essential, consult 3278/79 Emulation for valid colors and modes 
and the positions in the profile where they can be used. Correct the xxx file. 
Try again. 


In the "xxx" file, the foreground color "yyy" is not valid. The "emkey" 
command will continue without including this entry in the new keyboard 
profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: The yyy color definition in the profile uses a foreground color that is 
not valid. 


Action: If the redefinition of the color is not essential, no action is needed. If 
the redefinition is essential, consult 3278/79 Emulation for a valid foreground 
color, and correct the xxx file. Try again. 


B-30 3278/79 Emulation 


112-055 


112-056 


112-057 


In the "xxx" file, a line with a second color of "yyy" has two foreground 
colors. The "emkey" command will continue without including this 
incorrect entry in the new keyboard profile. 


To include this entry, replace one of the foreground colors with a 
background color, and try "emkey" again. 


Cause: A color definition in the profile uses two foreground colors. 


Action: If the redefinition of the color is not essential, no action is needed. If 
the redefinition is essential, replace one of the foreground colors with a 
background color. Try again. 


In the "xxx" file, the background color "yyy" is not valid. The "emkey" 
command will continue without including this entry in the new keyboard 
profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: The yyy color definition in the profile uses a background color that is 
not valid. 


Action: If the redefinition of the color is not essential, no action is needed. If 
the redefinition is essential, consult 3278/79 Emulation for a valid background 
color. Correct the xxx file. Try again. 


In the "xxx" file, a line with a second color of "yyy" has two background 
colors. The "emkey" command will continue without including this 
incorrect entry in the new keyboard profile. 


To include this entry, replace one of the background colors with a 
foreground color, and try "emkey" again. 


Cause: A color definition in the profile uses two background colors. 
Action: If the redefinition of the color is not essential, no action is needed. If 


the redefinition is essential, replace one of the background colors with a 
foreground color. Try again. 
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112-058 In the "xxx" file, the value "yyy" cannot be used with a foreground or 
background color. The "emkey" command will continue without 
including this entry in the new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: The yyy color definition in the profile uses a word that is not valid 
with a foreground or background color. 


Action: If the redefinition of the color is not essential, no action is needed. If 
the redefinition is essential, replace the incorrect word with one that is valid in 
a color definition. Try again. 


112-059 In the "xxx" file, "yyy" in the line 
zzz 
is not a valid attribute. The "emkey" command will continue without 
including this entry in the new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 
Cause: The profile contains an entry with a field attribute that is not valid. 
Action: If the redefinition of the color or mode of the attribute is not essential, 


no action is needed. If the redefinition is essential, replace the invalid word 
with a valid attribute. Try again. 


112-060 In the "xxx" file, the attribute in the line 


bo 
does not have a color assignment. The "emkey" command will continue 
without including this entry in the new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: The profile contains an entry with a field attribute, yyy, that has no 
color definition. 


Action: If the redefinition of the color of the attribute is not essential, no 


action is needed. If the redefinition is essential, include a defined color after 
the attribute. Try again. 
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112-061 


112-062 


In the "xxx" file, "yyy" in the line 

zzz 

is not a valid color for an attribute. The "emkey" command will 
continue without including this entry in the new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: The profile contains an entry with a color definition that is not valid 
for a field attribute. 


Action: If the redefinition of the color is not essential, no action is needed. If 
the redefinition is essential, use a valid color. Try again. 


In the "xxx" file, the line 

oe 

does not have a mode word following the "+" sign. The "emkey" 
command will continue without including this entry in the new keyboard 
profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 
Cause: The profile contains an entry with a valid color definition for a field 
attribute, followed by a + (plus sign), but does not follow the sign with a valid 
mode word. 

Action: If the redefinition of the attribute is not essential, no action is needed. 


If the redefinition is essential, follow the + (plus sign) with a valid mode word. 
Try again. 
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112-063 


112-064 


In the "xxx" file, "yyy" in the line 

zzz 

is not a valid mode word for an attribute. The "emkey" command will 
continue without including this entry in the new keyboard profile. 


To include this entry, correct the "xxx" file and try "emkey" again. 


Cause: The profile includes a color and a mode definition for a field attribute, 
but does not have a valid mode word. The invalid word is yyy. 


Action: If the redefinition of the attribute is not essential, no action is needed. 
If the redefinition is essential, use a valid mode word. Try again. 


The emulator cannot continue because the "ioctl" system call cannot 
issue a "query device ID". Please follow your local procedures for 
reporting problems. 


The following message gives more information about the error: message. 
Cause: You cannot use the display you want for emulation at this time. 
Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 


reporting problems. 


Technical Information: The ioctl call failed to query the device ID for the 
display you requested. 


B-34 3278/79 Emulation 


112-065 


112-066 


112-067 


You specified a display that the emulator does not recognize. The 
emulator will continue using the current display. 


Cause: You cannot change to the display you requested since the display was 
not one of those allowed with the em78 command. 


Action: Make sure you used one of the displays indicated for the -d flag in the 
em78 command. See “em78” on page 2-5 in 3278/79 Emulation. Try again. 


You specified a display that is not attached. The emulator will continue 
using the current display. 


Cause: You requested a display that is not part of your RT PC system. The 
display may not be attached. 


Action: Make sure the display you requested is connected to your RT PC. 
Follow your local procedures for reporting problems. 


The emulator cannot change to the display you requested because the 
"write" system call failed. The emulator will continue using the current 
display. 


The following message gives more information about the error: message. 


Cause: You cannot change displays. Perhaps you do not have write 
permission to the display. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 
reporting problems. 


Technical Information: If possible, check the permissions for the loadable 


POST for your display. See JBM RT PC Virtual Resource Manager Technical 
Reference for more information. 
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112-068 


112-069 


The emulator cannot restore the original foreground and background 
colors because the "write" system call failed. Please follow your local 
procedures for reporting problems. 


The following message gives more information about the error: message. 


Cause: You cannot return to the default display colors. Perhaps you do not 
have write permission to the display. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 
reporting problems. 


Technical Information: If possible, check the permissions for the loadable 
POST for your display. See JBM RT PC Virtual Resource Manager Technical 


Reference for more information. 


The emulator cannot continue because the "ioctl" system call cannot 
issue a "query real device" for the display. Please follow your local 
procedures for reporting problems. 


The following message gives more information about the error: message. 
Cause: You cannot use the display you want for emulation. 

Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 


reporting problems. 


Technical Information: The ioctl call failed to query the real device for the 
display you are using. 
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112-070 


112-071 


The emulator cannot restore the original display because the "write" 
system call failed. Please follow your local procedures for reporting 
problems. 


The following message gives more information about the error: message. 


Cause: You cannot return to the default display. Perhaps you do not have 
write permission to the display. 


Action: Make sure you have write permission. If the problem continues, try 
to locate the message in Messages Reference. You may be able to correct the 
error with the action indicated. If you cannot locate the message or the 
recommended action fails to help, follow your local procedures for reporting 
problems. 


The emulator cannot continue because the "semop" system call cannot 
unlock the 3278/79 emulation semaphore. Please follow your local 
procedures for reporting problems. 


The following message gives more information about the error: message. 


Cause: The emulator cannot continue because of a problem with the processes 
that make the operating system run. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 
reporting problems. 


Technical Information: You cannot invoke the emulator since a previous 
emulator command may have locked the semaphore. 
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112-072 The emulator cannot continue because the "semcti" system call cannot 
remove the 3278/79 emulation semaphore. Please follow your local 
procedures for reporting problems. 


The following message gives more information about the error: message. 


Cause: The emulator cannot continue because of a problem with the processes 
that make the operating system run. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, have someone with superuser authority 
follow the instructions in Technical Information. 


Technical Information: The emulator cannot remove a semaphore it created. 
The semaphore may still be in use due to an earlier failure of the emulation 
process. Get superuser authority and enter the em78 command. Then exit the 
emulator. 


112-073 The emulator cannot continue because the "semget" system call cannot 
get the 3278/79 emulation semaphore. Please follow your local 
procedures for reporting problems. 


The following message gives more information about the error: message. 


Cause: The emulator cannot continue because of a problem with the processes 
that make the operating system run. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, have someone with superuser authority 
follow the instructions in Technical Information. 


Technical Information: You cannot invoke the emulator because a previous 
emulator command may have locked the 3278/79 Emulation semaphore. The 
semaphore may have been created earlier by a process that did not end 
normally. Get superuser authority and enter the em78 command. Then exit the 
emulator. If this fails to help, follow your local procedures for reporting 
problems. 
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112-074 


112-075 


The emulator cannot continue because the "semctl" system call cannot 
initialize the 3278/79 emulation semaphore. Please follow your local 
procedures for reporting problems. 


The following message gives more information about the error: message. 


Cause: The emulator cannot continue because of a problem with the processes 
that make the operating system run. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 
reporting problems. 


Technical Information: The semaphore was created, but the emulator cannot 
give it values. 


The emulator cannot continue because the "semget" system call cannot 
create the 3278/79 emulation semaphore. Try "em78" again. If you still 
get this message, make sure that no one else is using 3278/79 emulation. 


The following message gives more information about the error: message. 


Cause: You cannot use the emulator because of a problem with the processes 
that make the operating system run. 


Action: Have someone follow the instructions in Technical Information. 

If the problem continues, try to locate the message in Messages Reference. You 
may be able to correct the error with the action indicated. If you cannot locate 
the message or the recommended action fails to help, follow your local 
procedures for reporting problems. 


Technical Information: Get superuser authority and enter the em78 
command. Then exit the emulator. 
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112-076 The emulator cannot continue because the "ioctl" system call cannot 
query the visual-sound register. Please follow your local procedures for 
reporting problems. 


The following message gives more information about the error: message. 


Cause: The emulator cannot continue because of a problem with the processes 
that make the operating system run. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 
reporting problems. 


Technical Information: The ioctl call failed to query the visual-sound 
register on the adapter. The purpose of the query was to issue a 3278/79 beep. 
112-077 You did not specify a “xxx” file. The emulator will use the “yyy” file. 
Cause: You pressed screensave or screenrepl but did not indicate a -sfile or 
-rfile when you invoked the emulator. The emulator will use a file whose name 
begins with home/emsav or home/emrep, where home is the name of your 
home directory. 
Action: No response is needed. 
112-078 The emulator cannot continue because the "/etc/locks/em78" file cannot 
be opened or cannot be created. 


The following message gives more information about the error: message. 


Cause: You tried to invoke the emulator when it was not in use, but a problem 
prevented opening or creating the file. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 
reporting problems. 


B-40 3278/79 Emulation 





112-079 


112-080 


The emulator cannot continue because the "/etc/locks/xfer" file exists. 


Cause: The /etc/locks/xfer file may exist because a previous file transfer is in 
progress, the emulator is active, or the file wasn’t removed because of an error. 


Action: Check to see if a previous file transfer is in progress or if the emulator 
is active. To do this, enter ps -e. If the emulator is active, you will see two 
copies of the em’78 file; if file transfer is in progress, you will see more than 
two copies of the em’78 file. 


If a previous file transfer is in progress or if the emulator is active, you can 
wait and try again, or you can cancel the task that is in progress. If you 
believe that /etc/locks/xfer exists because of an error, obtain permission, if 
necessary, and delete it. Try again. 


The emulator cannot continue because the "/etc/locks/xfer" file cannot 
be opened or cannot be created. 


The following message gives more information about the error: message. 


Cause: You tried to invoke the emulator when it was not in use, but a problem 
prevented opening or creating the /etc/locks/xfer file. The emulator must 
have this file to continue. There may be a problem with the processes that 
make the operating system run. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 
reporting problems. 
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112-081 The emulator cannot continue because the "ioctl" system call cannot 
reset the virtual interrupt mask. Please follow your local procedures for 
reporting problems. 


The following message gives more information about the error: message. 


Cause: The emulator could not continue because of a problem with the 
processes that make the operating system run. 


Action: Try to locate the message in Messages Reference. You may be able to 
correct the error with the action indicated. If you cannot locate the message or 
the recommended action fails to help, follow your local procedures for 
reporting problems. 


112-082 The “xxx” command cannot complete because an error occurred while 
processing your country selection. 


Cause: An error occurred while the system was processing the country you 
selected. For example, the system might not be able to find or copy a file it 
needs. 


Action: If any other messages appeared on the screen, try to take the 
appropriate action for them. Make sure your /usr directory is not full. Try the 
xxx command again. If you still get this message, follow your local procedures 
for reporting problems. 
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File Transfer Messages 


113-012 


The host system sent the following message: message. 


Cause: The host displayed one of the following TRANS messages in response 
to some condition that it detected. 


Action: Your response is determined by the content of the message. 


TRANSO3 File transfer complete. 
Cause: The file transfer operation has completed successfully. 
There is now a file either at the host or RT PC with the name and 
characteristics you specified in the emsend or the emrcev command. 


Action: No response is needed. 


TRANS0O4 File transfer complete, with records segmented. 
Cause: The file transfer operation has completed successfully. Any 
record greater than the set logical record length (LRECL) is divided 
into multiple records. 


Action: No response is needed. 


TRANS13 Error writing file to host: file transfer canceled. 
Cause: There may be a system error at the host. 
Action: Check the status of the host to see if there is any 


information about the problem. Take any action indicated and try 
file transfer again. 
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TRANS14 Error reading file from host: file transfer canceled. 
Cause: There may be a system error at the host. 
Action: Check the status of the host to see if there is any 
information about the problem. Take any action indicated and try 
file transfer again. 

TRANS15 Required host storage unavailable: file transfer canceled. 
Cause: You need more storage available on the host. 
Action: Obtain more virtual storage for the host session. Try file 
transfer again. If the problem persists, either have your storage limit 
increased at the host, or follow local procedures for reporting 
problems. 

TRANS16 Incorrect request code: file transfer canceled. 


Cause: A file transfer program error occurred. 


Action: Follow local procedures for reporting problems. 
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TRANS17 Missing or incorrect xxx : file transfer canceled. 


Cause: The xxx in the message can be either TSO data set name or 
CMS file identifier. 


If you are using TSO, one of the following has happened: 
e The TSO data set name is missing. 

e The TSO data set is not sequential. 

e The TSO data set is not partitioned. 


If you are using CMS, the CMS file name is missing or is not 
specified correctly. 


Action: If you are using TSO, correct the TSO data set name in the 
command, then try file transfer again. 


If you are using CMS, correct the CMS file name in the command, 
then try file transfer again. 

TRANS18 Incorrect option specified: file transfer canceled. 
Cause: You specified an invalid option. 
Action: Correct the command to specify an acceptable option and 
retry file transfer. 

TRANS19 Error reading or writing to host disk: file transfer canceled. 
Cause: There may be a system error at the host. 
Action: Check the status of the host to see if there is any 


information about the problem. Take any action indicated and try 
file transfer again. 
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TRANS28 Invalid option XXX: file transfer canceled. 


Cause: XXX is an option that is not recognized, is specified as a 
positional keyword, or has an associated value which is incorrect. 


Action: Correct the option in the command. Try file transfer again. 


TRANS29 Invalid option XXX with RECEIVE: file transfer canceled. 
Cause: XXX is an option valid with emsend but not with emrcv. 
Action: Remove the option from the command. Try file transfer 
again. 

TRANS30 Invalid option XXX with APPEND: file transfer canceled. 
Cause: XXX is an option that cannot be used with APPEND. 
Action: Remove the option from the command. Try file transfer 
again. 

TRANS31 Invalid option XXX without SPACE: file transfer canceled. 


Cause: XXX is an option that cannot be used unless SPACE is 
specified. 


Action: Remove the option from the command. Try file transfer 
again. 
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TRANS32 Invalid option XXX with PDS: file transfer canceled. 


Cause: XXX is an option that cannot be used with a host 
partitioned data set. 


Action: Remove the option from the command. Try file transfer 
again. 
TRANS33 Only one of TRACKS, CYLINDERS, AVBLOCK allowed: file 


transfer canceled. 


Cause: SPACE can be specified in units of TRACKS, or 
CYLINDERS, or AVBLOCK. Only one of these options can be used. 


Action: Remove the unwanted option from the command. Try file 
transfer again. 

TRANS34 CMS file not found: file transfer canceled. 
Cause: An existing CMS file must be specified for emrcv. 
Action: Correct the CMS file specification in the command. Try file 
transfer again. 

TRANS35 CMS disk is Read-Only: file transfer canceled. 


Cause: The CMS file mode specified with emsend must allow write 
access. 


Action: Correct the CMS file specification in the command. Try file 
transfer again. 
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TRANS36 CMS disk is not accessed: file transfer canceled. 
Cause: The CMS file mode is not in the CMS disk search order. 
Action: Access the required disk in CMS or correct the CMS file 
specification in the command. Try file transfer again. 

TRANS37 CMS disk is full: file transfer canceled. 
Cause: Either the CMS disk is full, or the maximum number of files 
(3400) on the minidisk or the maximum number of data blocks (16060) 
per file has been reached. 
Action: Use another disk with enough space, or remove unwanted 
files from the specified disk. If the RT PC file is very large (more 
than 1 megabyte), consider dividing it into several pieces. Try file 
transfer again. 

TRANS99 Host program error code XXXXXXXX: file transfer canceled. 


Cause: This message indicates a program error at the host. 


Action: Follow local procedures for reporting problems. 


113-013 File transfer cannot continue because the "write" system call cannot put 
data into the "xxx" file. Make sure you have write permission in your 
current directory. 

Cause: You tried to add data to a file, but you may not have write permission. 


Action: Make sure you have write permission in your current directory. Try 
again. 
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113-014 


113-015 


113-016 


File transfer cannot continue because the RT PC file "xxx" cannot be 
accessed. 


Cause: You invoked File Transfer with the -f flag and requested a file that 
cannot be found or created. 


Action: Make sure that the file exists and that you have read permission, 


write permission, or both. You need read permission to send a file, and write 
permission to receive a file. 


File transfer cannot continue because the "/dev/em78" special device 
cannot be opened. 


The following message gives more information about the error: message. 


Cause: If you receive a device busy message, you invoked File Transfer using a 
different ID than the ID you used when you invoked the emulator. 


Action: Use the same ID you used when you invoked the emulator. Try again 


to transfer the file. If the problem continues, install IBM RT PC 3278/79 
Emulation again, following the procedures in Appendix A of 3278/79 Emulation. 


File transfer cannot continue because the "lseek" system call failed. 
Please follow your local procedures for reporting problems. 


Cause: You cannot transfer a file, and the adapter may not be working 
properly. 


Action: Make sure the adapter is installed. Run the system diagnostics tests 
described in Problem Determination Guide. 


If the adapter is not defective, try to transfer the file again. If you still cannot 
transfer the file, follow your local procedures for reporting problems. 


Technical Information: The lseek command failed to locate the adapter. The 
emulator could not find the beginning of the communications buffer. 
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113-017 


113-018 


File transfer cannot continue because the "read" system call failed. 
Make sure the 3278/79 emulation adapter is working properly. 


Cause: You cannot transfer a file, and the adapter may not be working 
properly. 


Action: Make sure the adapter is installed. Run the system diagnostics tests 
described in Problem Determination Guide. 


If the adapter is not defective, try to transfer the file again. If you still cannot 
transfer the file, follow your local procedures for reporting problems. 


Technical Information: The emulator could not read the communications 
buffer. 


File transfer cannot continue because the "write" system call failed. 
Make sure the the 3278/79 emulation adapter is working properly. 


Cause: You cannot transfer a file, and the adapter may not be working 
properly. 


Action: Make sure the adapter is installed. Run the system diagnostics tests 
described in Problem Determination Guide. 


If the adapter is not defective, try to transfer the file again. If you still cannot 
transfer the file, follow your local procedures for reporting problems. 


Technical Information: The emulator could not write to the communications 


buffer. 


B-50 3278/79 Emulation 





113-019 The host has not responded for the last "xxx" seconds, but your 
transmission is not complete. Press Ctrl-D to return to the emulator, 
then make sure the host is still active. 


Cause: The host has not responded for the last xxx seconds. Your 
transmission is not complete, but file transfer cannot continue. 


Action: Hold the Ctrl key and press the D key to return to the emulator. 
Make sure that the host is active. Further response depends on the situation. 


Technical Information: The xxx seconds in the message refers to the wait 


time per frame of file transfer (not to the wait time for the entire file transfer 
session). 


113-020 File transfer cannot continue because of an error in communication 
with the host. Please follow your local procedures for reporting 
problems. 

Cause: There may be a problem with the host or with the line. 


Action: Follow your local procedures for reporting problems. 
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113-021 File transfer cannot continue because the system does not have enough 
available memory. 


Cause: Not enough memory space was available. 


Action: Try file transfer again when the system is less busy. If you get this 
message again, do one or more of the following: 


e Check the memory hardware. (See Problem Determination Guide for details). 

e Try the users command with the change subcommand to change the file 
size allowed for a user. See Using and Managing the AIX Operating System 
for information about users. 

e Follow your local procedures for reporting software problems. 

Technical Information: The malloc subroutine failed, and the system did not 

have enough virtual memory for file transfer to continue. 

113-022 File transfer cannot continue because the "ioctl" system call failed. 


Make sure the 3278/79 emulation adapter is working properly. 


Cause: You cannot transfer a file, and the adapter may not be working 
properly. 


Action: Make sure the adapter is installed. If it is, run the system diagnostics 
tests described in Problem Determination Guide. 


If the adapter is not defective, try to transfer the file again. If you still cannot 
transfer the file, follow your local procedures for reporting problems. 


Technical Information: The emulator could not read the control program. 
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113-024 


113-025 


File transfer cannot continue because the "signal" system call failed. 
Please follow your local procedures for reporting problems. 


Cause: Signal linkage could not be established. 


Action: Follow your local procedures for reporting problems. 


File transfer cannot continue because the "/etc/locks/xfer" fiie exists. 


Cause: The /etc/locks/xfer file may exist because a previous file transfer is in 
progress, the emulator is active, or the file wasn’t removed because of an error. 


Action: Check to see if a previous file transfer is in progress or if the emulator 
is active. To do this, enter ps -e. If the emulator is active, em/78 will appear 
twice in the list of active processes; if file transfer is in progress, em/78 will 
appear more than twice in the list of active processes. 


If a previous file transfer is in progress or if the emulator is active, you can 
wait and try again, or you can cancel the task that is in progress. If you 
believe that /etc/locks/xfer exists because of an error, obtain permission, if 
necessary, and delete it. Try again. 
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113-026 The File Transfer program cannot translate one or more characters in 
the "filename" file. Please check the contents of "filename". 


Cause: The filename file holds one or more characters that the File Transfer 
program cannot trai..l!ate. The program removed the untranslatable characters 
from filename. 


Action: Look at the contents of filename to be sure that the file is still 
readable. 


Technical Information: The untranslatable characters could be unexpected 
control characters in the data stream. File Transfer could not replace these 
characters with substitute characters. 


113-027 The "emsend or emrcv" command cannot continue because the "y" 
character used with the "-V" or "-T" host information flag is not valid. 


Cause: You requested the emsend or emrcv command, and you specified some 
host information with the -V or -T flag. However, the y character you used 
with that flag is not a valid character at the host. File Transfer cannot send 
the host information. 


Action: Try emsend or emrecv again, but do not use character y in the host 
information for the -V or -T flag. 
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Appendix C. Keyboard Information for Non-English 
Keyboards 
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Duplicate Keys for Swiss-French and Swiss-German ..............00-+0058 C-66 
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About This Appendix 


This appendix contains information useful to non-U.S. English 
customers. 


First, this appendix lists keys found on the RT PC keyboard that 
are not recognized by non-English host computers. For some 
languages, additional keys are available; these extra keys are listed 
here as well. 


Second, this appendix lists the valid keys for non-U.S. English 
customers. 


Finally, this appendix lists the keys for each language that perform 
the same function as other keys or key combinations. 
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Unsupported RT PC Keys 


Following are the lists of unsupported keys found on the RT PC keyboard for all 
languages except English (US). 


The keys themselves are valid, but the host computer in each of these languages does not 
recognize the characters displayed on that key. So, if you press one of these keys in 
3278/79 Emulation, you will hear a beep, and the character will not appear on your 
display. 


Note: If you have previously requested the AIX command sound -o, the sound will be 
turned off, and you will not be able to hear the beep. 
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Unsupported Keys for Austrian/German 


- Degree Symbol { 
[ Left Bracket } 
| Right Bracket \ 
: Acute Accent @ 


7 Tilde Accent 
Mm Mu Small 2 


Superscript 3 x 
+ Division Sign 


Unsupported Keys for Belgian 


Pipe Symbol @ 
z Superscript 2 8 
§ Section Symbol { 
} Right Brace a 
’ Acute Accent Tv 
ba Pounds Sterling \ 


ai Tilde Accent 


C-6 3278/79 Emulation 


Left Brace 
Right Brace 
Reverse Slash 
At Sign 

Pipe Symbol 
Superscript 2 


Multiplication Sign 


At Sign 
Superscript 3 
Left Brace 
Degree Symbol 
Greek Mu Small 


Reverse Slash 





Unsupported Keys for Canadian-French 


I+ 


OR Sign 

Plus or Minus Sign 
Cent Sign 

NOT Symbol 
Superscript 2 

One Fourth 

Three Fourths 
Paragraph Symbol 
Right Bracket 
Left Brace 

Left Angle Quotes 
Degree Symbol 


Overline, Overbar 


Reverse Slash 
Pounds Sterling 
International Currency Symbol (ICS) 
Pipe Symbol 
Superscript 3 

One Half 

Section Symbol 
Left Bracket 

Tilde Accent 

Right Brace 

Right Angle Quotes 
Micro Symbol 


Double Underscore 


Please see the next page for more information about the Canadian-French keyboard. 
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Additional Keys Available on the Canadian-French Keyboard 


These characters are not engraved on a key. Instead, they are composed of a non-spacing 
(dead key) character plus another character. 


~ ~ 


‘“aAeéEat U Characters with a grave accent 
' é E Characters with an acute accent 
a A é€ E if 6 0. Characters with a circumflex accent 
a U 
ékit av Characters with a diaeresis accent 
> ¢ C Characters with a cedilla accent 
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Unsupported Keys for Danish 


% One Half Fraction § Section Symbol 
@ At Sign £ Pounds Sterling 
$ Dollar Sign { Left Brace 

[ Left Bracket ] Right Bracket 

} Right Brace ; Acute Accent 
Pipe Symbol is Diaeresis Accent 


= Tilde Accent 
Additional Key Available on the Danish Keyboard 


This character is not engraved on a key. Instead, it is composed of a non-spacing (dead 
key) character plus another character. 


u Lowercase u with diaeresis accent 


Unsupported Keys for English (UK) 


2 Circumflex Accent [ Left Bracket 
] Right Bracket 2 Tilde Accent 
Additional Key Available on the English (UK) Keyboard 


es Overbar (key42_s) 
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Unsupported Keys for Finnish and Swedish 


£ Pounds Sterling $ 


Grave Accent ' 


x Multiplication Sign Yo 
Pipe Symbol @ 
# Number Sign [ 
] Right Bracket { 
} Right Brace 
Diaeresis Accent \ 


~~ Division Sign 


Dollar Sign 

Acute Accent 

One Half Fraction 
At Sign 

Left Bracket 

Left Brace 

Tilde Accent 


Reverse Slash 


Unsupported Keys for French (AZERTY) 


# Number Sign { 
[ Left Bracket 
\ Reverse Slash @ 
] Right Bracket 
Ll Greek Mu Small sol 


i) 


ee Tilde Accent 
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Left Brace 

Pipe Symbol 

At Sign 

Right Brace 

International Currency Symbol (ICS) 


Superscript 2 


Unsupported Keys for Italian 


\ Reverse Slash Pipe Symbol 

{ Left Brace } Right Brace 

~ Tilde Accent ’ Grave Accent 
[ Left Bracket ] Right Bracket 
@ At Sign # Number Sign 


Unsupported Keys for Japanese English 


- Circumflex Accent “ Tilde Accent 
[ Left Bracket ] Right Bracket 
\ Reverse Slash 


Additional Keys Available on the Japanese English Keyboard 


Vertical Bar (key kl_a) 


¥ Yen (key k5_a) 
Es Pounds Sterling (key k6_a) 
= NOT Symbol (key k1l_a) 
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Unsupported Keys for Norwegian 


Pipe Symbol § Section Symbol 

@ At Sign £ Pounds Sterling 

$ Dollar Sign { Left Brace 

[ Left Bracket } Right Brace 

] Right Bracket ' Acute Accent 
Diaeresis Accent - Tilde Accent 


Additional Key Available on the Norwegian Keyboard 


This character is not engraved on a key. Instead, it is composed of a non-spacing (dead 
key) character plus another character. 


u Lowercase u with diaeresis accent 
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Unsupported Keys for Portuguese 


\ Reverse Slash 
At Sign # 
£ Pounds Sterling § 
{ Left Brace } 
« Left Angle Quotes » 
Diaeresis Accent fe) 


a Ordinal Ind., Feminine - 


Pipe Symbol 
Number Sign 
Section Symbol 
Right Brace 

Right Angle Quotes 


Ordinal Ind., Masculine 


Tilde Accent 


Additional Keys Available on the Portuguese Keyboard 


These characters are not engraved on a key. Instead, they are composed of a non-spacing 


(dead key) character plus another character. 


4 A oO Characters with a tilde accent 
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Unsupported Keys for Spanish 


A 


Acute Accent 

c Cedilla, Capital 
Feminine Sign 
Product Dot 
Dollar Sign 
Inverted ! 


Circumflex Accent 


lO 


c Cedilla, Small 
Masculine Sign 
Exclamation Point 
Number Sign 
Tilde Accent 


Inverted ? 


Additional Key Available on the Spanish Keyboard 


Pts 
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peseta (key k5_s) 


Unsupported Keys for Swiss-French and Swiss-German 


; Acute Accent § Section Symbol 
° Degree Symbol | OR Symbol 

@ At Sign # Number Sign 
—| NOT Sign Pipe Symbol 

¢ Cent Sign Tilde Accent 

[ Left Bracket ] Right Bracket 

{ Left Brace : Right Brace 

\ Reverse Slash 


Additional Keys Available on the Swiss-French and Swiss-German Keyboard 


These characters are not engraved on a key. Instead, they are composed of a non-spacing 
(dead key) character plus another character. 


aeéeiou Characters with a grave accent 
aeit<e Characters with a circumflex accent 


4 A éi 6 Ou vt Characters with a diaeresis accent 
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Valid RT PC Key Names 


Valid RT PC Key Names for Austrian/German 


The following pages contain the names of all the recognized RT PC keys for 
Austrian/German. Use only the names listed to assign IBM RT PC 3278/79 Emulation 
functions to RT PC keys. 


— k1i_s kl_c kl_a -- 
k2 k2_s k2_¢ k2_a _ 
k3 k3_s k3_c k3_a k3_g 
k4 k4_s k4_¢c k4_a k4_¢ 
k5 k5_s k5_¢c k5_a — 
k6 k6_s k6_c k6_a — 
k7 k7_s k7_c k7_a — 
k8 k8_s k8_c k8_a k8_g 
k9 k9_s k9_c k9_a k9_g 
k10 k10_s k10_c k10_a k10_g 
k11 kll_s kll_c kll_a k11_¢ 
k12 k12_s k12_c k12_a k12_¢ 

— — k13_¢ k13_a — 
k15 k15_s k15_¢ k15_a — 
k16 k16_s k16_c k16_a — 
k17 k17_s k17_c k17_a k17_g¢g 
k18 k18_s k18_c¢c k18_a ao 
k19 k19_s k19_c k19_a — 
k20 k20_s k20_c k20_a — 
k21 k21_s k21_c¢c k21_a -- 
k22 k22_s k22_c¢ k22_a — 
k23 k23_s k23_c k23_a — 
k24 k24_s k24_¢ k24_a — 
k25 k25_s k25_c k25_a — 
k26 k26_s k26_c k26_a _ 
k27 k27_s k27_c k27_a — 
k28 k28_s k28_c¢c k28_a — 


Figure C-1 (Part 1 of 3). 
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k31 
k32 
k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k31_s 
k32_s 
k33_s 
k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51l_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 
k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


Figure C-1 (Part 2 of 3). 


k31_c 
k32_c 
k33_c 
k34_c 
k35_c 
k36_c 
k37_c 
k38_c 
k39_c 
k40_c 
k41_c 
k42_c¢c 
k43_c 


k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k51_c 
k52_c 
k58_c 
k54_c 
k55_ce 
k61_c 


k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c¢c 
k84_c 
k85_c 
k86_c 
k89_c 


k3l_a 
k32_a 
k33_a 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k41_a 
k42_a 
k43_a 


k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l_a 


k75_a 
k76_a 
k79_a 
k80_a 
k81_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 


Names of the RT PC Keys for Austrian/German 
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— — k90_c k90_a 
k91 k91_s k91_c — 
k92 k92_s k92_c¢ — 
k93 k93_s k93_c -- 
k95 k95_s k95_c k95_a 
k96 k96_s k96_c — 
k97 k97_s k97_c — 
k98 k98_s k98_c — 
k99 k99_s k99_c ~~ 
k100 k100_s k100_c k100_a 
k101 k101_s k101_c — 
k102 k102_s k102_c — 
k103 k103_s k103_c — 
k104 k104_s k104_c k104_a 
k105 k105_s k105_c k105_a 
k106 k106_s k106_c k106_a 
k108 k108_s k108_c k108_a 
k110 k110_s k110_c k110_a 
k112 k112_s k112_c¢c k112_a 
k113 k113_s k113_¢c k113_a 
k114 k114_s k114_¢c k114_a 
k115 k115_s k115_c k115_a 
k116 k116_s k116_c k116_a 
k117 k117_s k117_c k117_a 
k118 k118_s k118_c¢c k118_a 
k119 k119_s k119_c k119_a 
k120 k120_s k120_c k120_a 
k121 k121_s k121_c k121_a 
k122 k122_s k122_c k122_a 
k1238 k123_s k123_c k123_a 
k124 k124_s k124_¢ k124_a 
k125 k125_s k125_¢c k125_a 
k126 k126_s k126_c k126_a 


Figure C-1 (Part 3 of 3). Names of the RT PC Keys for Austrian/German. The suffix —s refers to 
the Shift key, —c refers to the Ctrl key, —a refers to the Alt key, and _g refers 
to the AltGr key. 


Note: The combination control + alternate + another key is not valid. 


C-18 3278/79 Emulation 


Valid RT PC Key Names for Belgian 


The following pages contain the names of all the recognized RT PC keys for Belgian. Use 
only the names listed to assign IBM RT PC 3278/79 Emulation functions to RT PC keys. 


kl 
k2 
k3 
k4 
k5 
k6 
k7 
k8 
k9 
k10 
k11 
k12 
k13 
k15 
k16 
k17 
k18 
k19 
k20 
k21 
k22 
k23 
k24 
k25 
k26 
k28 
k31 
k32 


ki_s 
k2_s 
k3_s 
k4_s 
k5_s 
k6_s 
k7_s 
k8_s 
k9_s 
k10_s 
kll_s 
k12_s 
k13_s 
k15_s 
k16_s 
k17_s 
k18_s 
k19_s 
k20_s 
k21_s 
k22_s 
k23_s 
k24_s 
k25_s 
k26_s 


k28_s 
k31_s 
k32_s 


Figure C-2 (Part 1 of 3). 


ki_c 
k2_c 
k3_c 
k4_¢c 
k5_c 
k6_c 
k7_c 
k8_c 
k9_c 
k10_c 
klil_c 
k12_c 
k13_c 
k15_c 
k16_c 
k17_c 
k18_c 
k19_c 
k20_c 
k21_¢ 
k22_¢c 
k23_c 
k24_¢ 
k25_c 
k26_c 
k2T_c 
k28_c¢c 
k31_c 
k32_c 


kl_a 
k2_a 
k3_a 
k4_a 
k5_a 
k6_a 
k7_a 
k8_a 
k9_a 
k10_a 
kll_a 
k12_a 
k13_a 
k1l5_a 
k16_a 
k17_a 
k18_a 
k19_a 
k20_a 
k21_a 
k22_a 
k23_a 
k24_a 
k25_a 
k26_a 
k27_a 
k28_a 
k31_a 
k32_a 


Names of the RT PC Keys for Belgian 


Non-English Keyboards 


k2_¢ 
k3_g 
k4_¢g 


k7_g 


k10_¢g 
k1l_g 
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k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k33_s 
k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 
k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


Figure C-2 (Part 2 of 3). 
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k33_c 
k34_¢c 
k35_c 
k36_c 
k37_¢c 
k38_c 
k39_c 
k40_c 
k41_c 
k43_¢ 
k45_c 
k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k51_c 
k52_c 
k53_¢ 
k54_¢ 
k55_c¢ 
k61_c 
k75_¢e 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 
k84_c 
k85_c 
k86_c 
k89_c 


k33_a 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k4l_a 


k43_a 
k45_a 
k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l_a 


k75_a 
k76_a 
k79_a 
k80_a 
k8l_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 


Names of the RT PC Keys for Belgian 


k91 

k92 

k93 

k95 

k96 

k97 

k98 

k99 

k100 
k101 
k102 
k103 
k104 
k105 
k106 
k108 
k110 
k112 
k113 
k114 
k115 
k116 
k117 
k118 
k119 
k120 
k121 
k122 
k123 
k124 
k125 
k126 


Figure C-2 (Part 3 of 3). 


Note: The combination control + alternate + another key is not valid. 


k91_s 

k92_s 

k93_s 

k95_s 

k96_s 

k97_s 

k98_s 

k99_s 

k100_s 
k101_s 
k102_s 
k103_s 
k104_s 
k105_s 
k106_s 
k108_s 
k110_s 
k112_s 
k113_s 
k114_s 
k115_s 
k116_s 
k117_s 
k118_s 
k119_s 
k120_s 
k121_s 
k122_s 
k123_s 
k124_s 
k125_s 
k126_s 


k90_c 

k91_c 

k92_c¢ 

k93_c 

k95_c 

k96_c 

k97_c 

k98_c 

k99_c 

k100_c 
k101_c 
k102_c 
k103_c 
k104_c 
k105_c 
k106_c 
k108_c 
k110_c 
k112_c 
k113_c 
k114_¢c 
k115_c 
k116_c 
k117_c 
k118_c 
k119_c 
k120_c 
k121_c¢c 
k122_c 
k123_c 
k124_c¢ 
k125_c 
k126_c 


Names of the RT PC Keys for Belgian. 


k90_a 


k100_a 


k104_a 
k105_a 
k106_a 
k108_a 
k110_a 
k112_a 
k113_a 
k114_a 
k115_a 
k116_a 
k117_a 
k118_a 
k119_a 
k120_a 
k121_a 
k122_a 
k123_a 
k124_a 
Kk125_a 
k126_a 


The suffix —s refers to the Shift 


key, —c refers to the Ctrl key, —a refers to the Alt, and —g refers to the AltGr 


key. 


Non-English Keyboards 


C-21 


Valid RT PC Key Names for Canadian-French 


The following pages contain the names of all the recognized RT PC keys for 


Canadian-French. Use only the names listed to assign IBM RT PC 3278/79 Emulation 


functions to RT PC keys. 


k1_s 
k2_s 
k3_s 
k4_s 
k5_s 
k6_s 
K7_s 
k8_s 
k9_s 
k10_s 
k1ll_s 
k12_s 
k13_s 
k15_s 
k16_s 
k17_s 
k18_s 
k19_s 
k20_s 
k21_s 
k22_s 
k23.8 
k24_s 
k25_s 
k26_s 


k31_s 


Figure C-3 (Part 1 of 3). 
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kl_e 
k2_¢ 
k3_c 
k4_¢c 
k5_c 
k6_c 
ki_c 
k8_c 
k9_c 
k10_c 
kll_c 
k12_¢ 
k13_¢ 
k15_c 
k16_c 
k17_c 
k18_c 
k19_c 
k20_c 
k21_c 
k22_¢ 
k23_c 
k24_¢ 
k25_c 
k26_c 
k27_c 
k28_¢ 
k3l_c 


kl_a 
k2_a 
k3_a 
k4_a 
k5_a 
k6_a 
k7_a 
k8_a 
k9_a 
k10_a 
kll_a 
k12_a 
k13_a 
k15_a 
k16_a 
k17_a 
k18_a 
k19_a 
k20_a 
k21_a 
k22_a 
k23_a 
k24_a 
k25_a 
k26_a 
k27_a 
k28_a 
k3l_a 


Names of the RT PC Keys for Canadian-French 





k32 
k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k32_s 
k33_s 
k34_s 
k35_s 
k36_s 
k37_s 
k88_s 
k39_s 
k40_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 
k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


Figure C-3 (Part 2 of 3). 


k32_c 
k33_c¢ 
k34_c 
k35_c¢c 
k36_c 
k387_c 
k38_c 
k39_c 
k40_c 
k41_c 
k42_c¢ 
k43_c¢c 


k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k51_c 
k52_c 
k53_c 
k54_c 
k55_c 
k61_c 
k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 
k84_c¢c 
k85_c 
k86_c 
k89_c 


k32_a 
k33_a 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k41_a 
k42_a 
k43_a 
k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l_a 
k75_a 
k76_a 
k79_a 
k80_a 
k81l_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 


Names of the RT PC Keys for Canadian-French 


Non-English Keyboards 


C-23 


— — k90_c k90_a 
k91 k91_s k91_c — 
k92 k92_s k92_c¢ _ 
k93 k93_s k93_c — 
k95 k95_s k95_c k95_a 
k96 k96_s k96_c — 
k97 k97_s k97_c = 
k98 k98_s k98_c — 
k99 k99_s k99_c — 
k100 k100_s k100_c k100_a 
k101 k101_s k101_c¢ — 
k102 k102_s k102_c — 
k103 k103_s k103_c _ 
k104 k104_s k104_¢ k104_a 
k105 k105_s k105_c k105_a 
k106 k106_s k106_c k106_a 
k108 k108_s k108_c k108_a 
k110 k110_s k110_c k110_a 
k112 k112_s k112_c¢c k112_a 
k113 k113_s k113_c k113_a 
k114 k114_s k114_¢c k114_a 
k115 k115_s k115_c k115_a 
k116 k116_s k116_c k116_a 
k117 k117_s k117_c k117_a 
k118 k118_s k118_c¢c k118_a 
k119 k119_s k119_c k119_a 
k120 k120_s k120_c k120_a 
k121 k121_s k121_c k121_a 
k122 k122_s k122_c¢ k122_a 
k123 k123_s k123_c k123_a 
k124 k124_s k124_¢ k124_a 
k125 k125_s k125_c k125_a 
k126 k126_s k126_c k126_a 


Figure C-3 (Part 3 of 3). Names of the RT PC Keys for Canadian-French. The suffix —s refers to the 
Shift key, —c refers to the Ctrl key, —a refers to the Alt key, and _g refers to 
the AltGr key. 


Note: The combination control + alternate + another key is not valid. 


C-24 3278/79 Emulation 


Valid RT PC Key Names for Danish 


The following pages contain the names of all the recognized RT PC keys for Danish. Use 
only the names listed to assign IBM RT PC 3278/79 Emulation functions to RT PC keys. 


kl 
k2 
k3 
k4 
k5 
k6 
k7 
k8 
k9 
k10 
k11 
k12 
k15 
k16 
k17 
k18 
k19 
k20 
k21 
k22 
k23 
k24 
k25 
k26 
k27 
k31 
k32 
k33 


k1i_s 
k2_s 
k3_s 
k4_s 
k5_s 
k6_s 
E7_s 
k8_s 
k9_s 
k10_s 
k11_s 
k12_s 


k15_s 
k16_s 
ym: 
k18_s 
k19_s 
k20_s 
k21_s 
k22_s 
k23_s 
k24_s 
k25_s 
k26_s 
k27_s 
k31_s 
k32_s 
k33_s 


Figure C-4 (Part 1 of 3). 


k2_¢ 

k3_c 

k4_¢ 

k5_c 

k6_c 

k7_c 

k8_c 

k9_c 

k10_c 
kll_c 
k12_c 
k13_c¢ 
kI5_c 
k16_c 
k17_c 
k18_¢c 
k19_c 
k20_c 
k21_c 
k22_c¢ 
k23_c 
k24_¢c 
k25_c 
k26_c 
k27_c 
k28_c 
k31_c 
k32_c 
k33_c¢c 


kl_a 
k2_a 
k3_a 
k4_a 
k5_a 
k6_a 
k7_a 
k8_a 
k9_a 
k10_a 
kll_a 
k12_a 
k13_a 
k1l5_a 
k16_a 
k17_a 
k18_a 
k19_a 
k20_a 
k21_a 
k22_a 
k23_a 


Names of the RT PC Keys for Danish 


Non-English Keyboards 


k3_g 
k4_¢ 
k5_g 
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k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 
k91 
k92 


k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 
k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 
k91_s 
k92_s 


Figure C-4 (Part 2 of 3): 
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k34_¢c 
k35_c 
k36_c 
k37_c 
k38_c 
k39_c 
k40_c 
k41_ce 
k42_¢ 
k43_c 
k45_c 
k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k51_c 
k52_¢c 
k53_c 
k54_c 
k55_¢c 
k61_c 


k75_c¢c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_¢ 
k84_¢ 
k85_c 
k86_c 
k89_c 
k90_c 
k91_c 
k92_¢ 


k34_a 
k35_a 
k36_a 
k387_a 
k388_a 
k39_a 
k40_a 
k41_a 
k42_a 
k43_a 
k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l1_a 


k75_a 
k76_a 
k79_a 
k80_a 
k81l_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 


Names of the RT PC Keys for Danish 


k93 

k95 

k96 

k97 

k98 

k99 

k100 
k101 
k102 
k103 
k104 
k105 
k106 
k108 
k110 
k112 
k113 
k114 
k115 
k116 
k117 
k118 
k119 
k120 
k121 
k122 
k123 
k124 
k125 
k126 


Figure C-4 (Part 3 of 3). 


Note: The combination control + alternate + another key is not valid. 


k93_s 

k95_s 

k96_s 

k97_s 

k98_s 

k99_s 

k100_s 
k101_s 
k102_s 
k103_s 
k104_s 
k105_s 
k106_s 
k108_s 
k110_s 
k112_s 
k113_s 
k114_s 
k115_s 
k116_s 
k117_s 
k118_s 
k119_s 
k120_s 
k121_s 
k122_s 
k123_s 
k124_s 
k125_s 
k126_s 


k93_c 
k95_c 
k96_c 
k97_c 
k98_c 
k99_c 
k100_c 
k101_c 
k102_c 
k103_c 
k104_c 
k105_c 
k106_c 
k108_c 
k110_c 
k112_c 
k113_c 
k114_¢c 
K11L5 6 
k116_c 
k117_c 
k118_c 
k119_c 
k120_c 
k121_c 
k122_c 
k123_c 
k124_c¢ 
k125_c 
k126_c 


k104_a 
k105_a 
k106_a 
k108_a 
k110_a 
k112_a 
k113_a 
k114_a 
k115_a 
k116_a 
k117_a 
k118_a 
k119_a 
k120_a 
k121_a 
k122_a 
k123_a 
k124_a 
k125_a 
k126_a 


Names of the RT PC Keys for Danish. The suffix —s refers to the Shift key, 


_c refers to the Ctrl key, —a refers to the Alt key, and —g refers to the AltGr 


key. 


Non-English Keyboards 
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Valid RT PC Key Names for English (UK) 


The following pages contain the names of all the recognized RT PC keys for English 
(UK). Use only the names listed to assign IBM RT PC 3278/79 Emulation functions to RT 


PC keys. 


k1 k1_s kl_c kl_a kl1_g 
k2 k2_s k2_c k2_a _- 
k3 k3_s k3_e k3_a — 
k4 k4_s k4_¢ k4_a — 
k5 k5_s k5_¢ k5_a — 
k6 k6_s k6_c k6_a — 
k7 k7_s k7_c k7_a -~ 
k8 k8_s k8_c k8_a — 
k9 k9_s k9_c k9_a — 
k10 k10_s k10_c k10_a — 
k11 kl1_s kli_c kll_a — 
k12 k12_s k12_c k12_a — 
k13 k13_s k13_c k13_a - 
k15 k15_s k15_¢c k15_a — 
k16 k16_s k16_c k16_a — 
k17 k17_s k17_c k17_a — 
k18 k18_s k18_c k18_a — 
k19 k19_s k19_c k19_a — 
k20 k20_s k20_c k20_a — 
k21 k21_s k21_¢ k21_a — 
k22 k22_s k22_c¢ k22_a _ 
k23 k23_s k23_c k23_8 a 
k24 k24_s k24_¢ k24_a = 
k25 k25_s k25_c k25_a -— 
k26 k26_s k26_c k26_a 
k27 k27_s k27_c k27_a — 
k28 k28_s k28_c k28_a _- 
k31 k81_s k3l1_c k3l_a — 
k32 k32_s k32_¢ k32_a — 


Figure C-5 (Part 1 of 3). 
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Names of the RT PC Keys for English (UK) 


k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k33_s 
k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 
k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


Figure C-5 (Part 2 of 3). 


k33_c¢c 
k34_¢ 
k35_c 
k36_c 
k37_c 
k38_c 
k39_c 
k40_c 
k41_c 


k43_c 
k45_c 
k46_c 
k47_c 
k48_¢ 
k49_c 
k50_c 
k51_c 
k52_¢ 
k53_c 
k54_c 
k55_c¢ 
k61_c 
k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 
k84_c 
k85_c 
k86_c 
k89_c 
k90_c 


Names of the RT PC Keys for English (UK) 


Non-English Keyboards 
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k91 

k92 

k93 

k95 

k96 

k97 

k98 

k99 

k100 
k101 
k102 
k103 
k104 
k105 
k106 
k108 
k110 
k112 
k113 
k114 
k115 
k116 
k117 
k118 
k119 
k120 
k121 
k122 
k123 
k124 
k125 
k126 


Figure C-5 (Part 3 of 3). 


k91_s 

k92_s 

k93_s 

k95_s 

k96_s 

k97_s 

k98_s 

k99_s 

k100_s 
k101_s 
k102_s 
k103_s 
k104_s 
k105_s 
k106_s 
k108_s 
k110_s 
k112_s 
k113_s 
k114_s 
k115_s 
k116_s 
k117_s 
k118_s 
k119_s 
k120_s 
k121_s 
k122_s 
k123_s 
k124_s 
k125_s 
k126_s 


k91_c 

k92_¢ 

k93_c 

k95_c 

k96_c 

k97_c 

k98_c 

k99_c 

k100_c 
k101_c 
k102_c 
k103_c 
k104_c 
k105_c 
k106_c 
k108_c 
k110_c 
k112_¢ 
k113_c 
k114_c¢c 
k115_c 
k116_c 
k117_c 
k118_c 
k119_c 
k120_c 
k121_c 
K122_¢ 
k123_c 
k124_¢ 
k125_c¢ 
k126_c 


k104_a 
k105_a 
k106_a 
k108_a 
k110_a 
k112_a 
k113_a 
k114_a 
k115_a 
k116_a 
k117_a 
k118_a 
k119_a 
k120_a 
k121_a 
k122_a 
k123_a 
k124_a 
k125_a 
k126_a 


Names of the RT PC Keys for English (UK). 
Shift key, —c refers to the Ctrl key, a refers to the Alt key, and _g refers to 
the AltGr key. 


The suffix —s refers to the 


Note: The combination control + alternate + another key is not valid. 


C-30 3278/79 Emulation 


Valid RT PC Key Names for Finnish and Swedish 


The following pages contain the names of all the recognized RT PC keys for Finnish and 
Swedish. Use only the names listed to assign IBM RT PC 3278/79 Emulation functions to 


RT PC keys. 


k15 
k16 
k17 
k18 
k19 
k20 
k21 
k22 
k23 
k24 
k25 
k26 
k27 
k31 
k32 


klus 
k2_s 
ae. 
k4_s 
k5_s 
k6_s 
k7_s 
k8_s 
k9_s 
k10_s 
k1ll_s 
k12_s 
k15_s 
k16_s 
k17_s 
k18_s 
k19_s 
k20_s 
k21_s 
k22_s 
k23_s 
k24_s 
k25_s 
k26_s 
k27_s 


k31_s 
k32_s 


Figure C-6 (Part 1 of 3). 


kl_c 
k2_¢ 
k3_c 
k4_¢c 
k5_c 
k6_c 
k7_¢c 
k8_c 
k9_c 
k10_c 
kll_c 
k12c 
k13_c¢c 
k15_¢c 
k16_c 
k17_c 
k18_c 
k19_c 
k20_c 
k21_c 
k22_¢ 
k23_¢c 
k24_¢ 
k25_c 
k26_c 
k27_c 
k28_c 
k31_c 
k32_¢c 


kl_a 
k2_a 


k4_a 
k5_a 
k6_a 
k7_a 


Names of the RT PC Keys for Finnish and Swedish 


Non-English Keyboards 


kl1_g 


C-31 


k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k33_s 
k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 
k75.8 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


Figure C-6 (Part 2 of 3). 


C-32 3278/79 Emulation 


k33_c 
k34_¢c 
k35_c 
k36_c 
k37_c 
k38_c 
k39_c 
k40_c 
k41_c 


k43_c 
k45_c 
k46_c 
k47_c 
k48_c¢ 
k49_c 
k50_c 
k51_c 
k52_c 
k53_c 
k54_¢c 
k55_c 
k61_c 


k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 
k84_c¢c 
k85_c 
k86_c 
k89_c 
k90_c 


k33_a 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k41_a 


k43_a 


- k45_a 


k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l1_a 


k75_a 
k76_a 
k79_a 
k80_a 
k81_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 


Names of the RT PC Keys for Finnish and Swedish 


k91 

k92 

k93 

k95 

k96 

k97 

k98 

k99 

k100 
k101 
k102 
k103 
k104 
k105 
k106 
k108 
k110 
k112 
k113 
k114 
k115 
k116 
k117 
k118 
k119 
k120 
k121 
k122 
k123 
k124 
k125 
k126 


Figure C-6 (Part 3 of 3). 


Note: The combination control + alternate + another key is not valid. 


k91_s 

k92_s 

k93_s 

k95_s 

k96_s 

k97_s 

k98_s 

k99_s 

k100_s 
k101_s 
k102_s 
k103_s 
k104_s 
k105_s 
k106_s 
k108_s 
k110_s 
k112_s 
KL1as 
k114_s 
k115_s 
k116_s 
k117_s 
k118_s 
k119_s 
k120_s 
k121_s 
k122_s 
k123_s 
k124_s 
k125_s 
k126_s 


k91_c 

k92_c 

k93_c 

k95_c 

k96_c 

k97_c 

k98_c 

k99_c 

k100_c 
k101_c 
k102_c 
k103_c 
k104_c 
k105_c 
k106_c 
k108_c 
k110_c 
k112_¢ 
k113_c¢ 
k114_¢c 
k115_c 
k116_c 
k117_c 
k118_c 
k119_c 
k120_c 
k121_c 
k122_¢ 
k123_c¢ 
k124_c¢ 
k125_c 
k126_c 


k104_a 
k105_a 
k106_a 
k108_a 
k110_a 
k112_a 
k113_a 
k114_a 
k115_a 
k116_a 
k117_a 
k118_a 
k119_a 
k120_a 
k121_a 
k122_a 
k123_a 
k124_a 
k125_a 
k126_a 


Names of the RT PC Keys for Finnish and Swedish. The suffix —s refers to 


the Shift key, —c refers to the Ctrl key, _a refers to the Alt key, and —_g refers 
to the AltGr key. 


Non-English Keyboards 


C-33 





Valid RT PC Key Names for French (AZERTY) 


The following pages contain the names of all the recognized RT PC keys for French 
(AZERTY). Use only the names listed to assign IBM RT PC 3278/79 Emulation functions 


to RT PC keys. 


kl kl_s kl_c kl_a ~ 
k2 k2_s k2_c k2_a — 
k3 k3_s k3_c k3_a k3_g 
k4 k4_s k4_c k4_a k4_¢ 
k5 k5_s k5_c k5_a k5_g 
k6 k6_s k6_c k6_a k6_¢ 
k7 k7_s k7_c k7_a k7_g 
k8 k8_s k8_c k8_a k8_¢ 
k9 k9_s k9_c k9_a k9_¢ 
k10 k10_s k10_c k10_a k10_g 
k11 k1ll_s k1ll_c kll_a k1ll_g 
k12 k12_s k12_¢ k12_a k12_¢ 
k13 k13_s k13_c k13_a k13_g 
k15 k16.s k15_c k1l5_a — 
k16 k16_s k16_¢c k16_a — 
k17 k17_s k17_c kl7_a _ 
k18 k18_s k18_c k18_a — 
k19 k19_s k19_c k19_a i 
k20 k20_s k20_c k20_a — 
k21 k21_s k21_c k21_a — 
k22 k22_s k22_¢ k22_a — 
k23 k23_s k23_c k23_a — 
k24 k24_s k24_c¢ k24_a _ 
k25 k25_s k25_-é k25_a — 
k26 k26_s k26_c k26_a — 
_ — k27_c k27_a — 
k28 k28_s k28_c k28_a k28_¢ 
k31 k81_s kale k3l_a — 
k82 k32_s k382_c¢c k32_a — 


Figure C-7 (Part 1 of 3). 


C-34 3278/79 Emulation 


Names of the RT PC Keys for French (AZERTY) 


k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k33_s 
k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 


k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


Figure C-7 (Part 2 of 3). 


k33_c 
k34_c 
k35_c 
k36_c 
k37_c 
k38_c 
k39_c 
k40_c 
k41_c 
k42_¢ 
k48_c 


k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k5l_c 
k52_c 
k53_ic 
k54_c 
k55_c 
k61_c 


k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 
k84_c 
k85_c 
k86_c 
k89_c 
k90_c 


k33_a 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k41_a 
k42_a 
k43_a 
k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k51l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k61_a 
k75_a 
k76_a 
k79_a 
k80_a 
k81_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 


Names of the RT PC Keys for French (AZERTY) 


Non-English Keyboards 


C-35 


LLANE SELENE OS SEIS SA TERS ET RT AEST PPLE FEES FSP LENS AES ERED SORRY TEREST SEI LT SARIS aS FSR ES NEE RAREST MARES NAS CR 5 SA Ah ARSC 2 SY aE SS AMES AEE YDS TORRES FCS 


k91 k91_s k91_c — — 
k92 k92_s k92_c — — 
k93 k93_s k93_c¢c — _ 
k95 k95_s k95_c k95_a — 
k96 k96_s k96_c — — 
k97 k97_s k97_c — — 
k98 k98_s k98_c — — 
k99 k99_s k99_c — — 
k100 k100_s k100_c k100_a — 
k101 k101_s k101_c _ — 
k102 k102_s k102_c — — 
k103 k103_s k1038_c o — 
k104 k104_s k104_¢c k104_a — 
k105 k105_s k105_c k105_a — 
k106 k106_s k106_c k106_a — 
k108 k108_s k108_c k108_a — 
k110 k110_s k110_c k110_a — 
k112 k112_s k112_c k1i? a — 
k113 k113_s k113_c k113_a — 
k114 k114_s k114_c¢ k114_a — 
k115 k115_s k115_c k115_a — 
k116 k116_s k116_c k116_a — 
k117 k117_s k117_c k117_a — 
k118 k118_s k118_c¢c k118_a — 
k119 k119_s k119_c k119_a — 
k120 k120_s k120_c k120_a — 
k121 k121_s ki21_e k121_a — 
k122 k122_s k122_¢ k122_9 — 
k123 k123_s k123_c¢ k123_a — 
k124 k124_s k124_¢ k124_a — 
k125 k125_s k125_c¢c k125_a — 
k126 k126_s k126_c k126_a — 


Figure C-7 (Part 3 of 3). Names of the RT PC Keys for French (AZERTY). The suffix —s refers to 
the Shift key, _c refers to the Ctrl key, _a refers to the Alt key, and _g refers 
to the AltGr key. 


Note: The combination control + alternate + another key is not valid. 


C-36 3278/79 Emulation 





Valid RT PC Key Names for Italian 


The following pages contain the names of all the recognized RT PC keys for Italian. Use 
only the names listed to assign IBM RT PC 3278/79 Emulation functions to RT PC keys. 


k18 
k19 
k20 
k21 
k22 
k23 
k24 
k25 
k26 
k27 
k28 
k31 
k32 
k33 


kl_s 
k2_s 
k8_s 
k4_s 
k5_s 
k6_s 
k7_s 
k8_s 
k9_s 
k10_s 
k1l1_s 
k12_s 
k15_s 
k16_s 
k17_s 
k18_s 
k19_s 
k20_s 
k21_s 
k22_s 
k23_s 
k24_s 
k25_s 
k26_s 
k27_s 
k28_s 
k31_s 
k32_s 
k33_s 


Figure C-8 (Part 1 of 3). 


ki1_c 

k2_c 

k3_c 

k4_¢ 

k5_c 

k6_c 

k7_c 

k8_c 

k9_c 

k10_c 
kll_c 
k12_c 
k13_c 
k15_c 
k16_c 
k17_c 
k18_¢c 
k19_c 
k20_c 
k21_c 
k22_¢ 
k23_c 
k24_¢c 
k25_¢c 
k26_c 
k27_c 
k28_c¢c 
k3l_c 
k32_c 
k33_c 


kl_a 

k2_a 

k3_a 

k4_a 

k5_a 

k6_a 

kia 

k8_a 

k9_a 

k10_a 
kll_a 
k12_a 
k13_a 
k15_a 
k16_a 
k17_a 
k18_a 
k19_a 
k20_a 
k21_a 
k22_a 
k23_a 
k24_a 
k25_a 
k26_a 
k27_a 
k28_a 
k3l_a 
k32_a 
k3a_a 


Names of the RT PC Keys for Italian 


Non-English Keyboards 


C-37 


k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 
k91 
k92 


k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 


k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


k91_s 
k92_s 


Figure C-8 (Part 2 of 3). 


C-38 3278/79 Emulation 


k34_c 
k35_c 
k36_c 
k387_c 
k38_c 
k39_c 
k40_c 
k41_c 
k42_¢c 
k43_c 
k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k5l_c 
k52_c 
k53_¢ 
k54_c¢c 
k55_c 
k61_c 


k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 
k84_c¢c 
k85_c 
k86_c 
k89_c 
k90_c 
k91_c 
k92_c¢ 


k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k4l_a 
k42_a 
k43_a 


k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l_a 


k75_a 
k76_a 
k79_a 
k80_a 
k81l_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 


Names of the RT PC Keys for Italian 


k93 

k95 

k96 

k97 

k98 

k99 

k100 
k101 
k102 
k103 
k104 
k105 
k106 
k108 
k110 
k112 
k113 
k114 
k115 
k116 
k117 
k118 
k119 
k120 
k121 
k122 
k123 
k124 
k125 
k126 


Figure C-8 (Part 3 of 3). 


Note: The combination control + alternate + another key is not valid. 


k93_s 

k95_s 

k96_s 

k97_s 

k98_s 

k99_s 

k100_s 
k101_s 
k102_s 
k103_s 
k104_s 
k105_s 
k106_s 
k108_s 
k110_s 
k112_s 
k113_s 
k114_s 
k115_s 
k116_s 
k117_s 
k118_s 
k119_s 
k120_s 
k121_s 
k122_s 
k123_s 
k124_s 
k125_s 
k126_s 


k93_¢c 

k95_c 

k96_c 

k97_c 

k98_c 

k99_c 

k100_c 
k101_c 
k102_c 
k103_c 
k104_c 
k105_c 
k106_c 
k108_c 
k110_c 
k112_¢c 
k113_c 
k114_c¢c 
k115_¢c 
k116_c 
k117_c 
k118_c 
k119_c 
k120_c 
k121_c 
k122_c¢ 
k123_c¢ 
k124_¢ 
k125_c 
k126_c 


k104_a 
k105_a 
k106_a 
k108_a 
k110_a 
k112_a 
k113_a 
k114_a 
k115_a 
k116_a 
k117_a 
k118_a 
k119_a 
k120_a 
k121_a 
k122_a 
k123_a 
k124_a 
k125_a 
k126_a 


Names of the RT PC Keys for Italian. The suffix —_s refers to the Shift key, 


_c refers to the Ctrl key, —a refers to the Alt key, and _g refers to the AltGr 


key. 


Non-English Kevboards 


C-39 


Valid RT PC Key Names for Japanese English 


The following pages contain the names of all the recognized RT PC keys for Japanese 
English. Use only the names listed to assign IBM RT PC 3278/79 Emulation functions to 
RT PC keys. 


— kl_s ki1_c kl_a 
k2 k2_s k2_¢ k2_a 
k3 k3_s k3_¢c k3_a 
k4 k4_s k4_¢ k4_a 
k5 k5_s k5_c k5_a 
k6 k6_s k6_c k6_a 
k7 Ky.8 k7_c k7_a 
k8 k8_s k8_c k8_a 
k9 k9_s k9_c k9_a 
k10 k10_s k10_c k10_a 
k11 k1ll_s klli_c kll_a 
k12 k12_s k12_c k12_a 
k13 — k13_c k13_a 
k15 k15_s k15_c k15_a 
k16 k16_s k16_c k16_a 
k17 k17_s k17_c k17_a 
k18 k18_s k18_c k18_a 
k19 k19_s k19_c k19_a 
k20 k20_s k20_c k20_a 
k21 k21_s k21_c k21_a 
k22 k22_s k22_c¢ k22_a 
k23 k23_s k23_c k23_a 
k24 k24_s k24_¢ k24_a 
k25 k25_s k25_c k25_a 
k26 k26_s k26_c k26_a 
k27 k27_s ~~ k27_a 
k28 k28_s k28_c k28_a 
k31 k31_s k31_c k3l_a 
k32 k32_s k32_c k32_a 


Figure C-9 (Part 1 of 3). 


(_An 


2972/73 KRmiulatian 


Names of the RT PC Keys for Japanese English 





k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k56 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 
k91 
k92 


k33_s 
k34_s 
k35_s 
k36_s 
k3/_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k56_s 
k61_s 


k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


k91_s 
k92_s 


Figure C-9 (Part 2 of 3). 


k33_c 
k34_¢c 
k35_c 
k36_c 
k37_c 
k38_c 
k39_c 
k40_c 
k41_c 
k42_c 
k43_c¢c 
k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k51_c 
k52_c¢ 
k53_c 
k54_c 
k55_c 
k56_c 
k61_c 
k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 
k84_c 
k85_c 
k86_c 
k89_c 
k90_c 
k91_c 
k92_c¢c 


k33_a 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k4l_a 


k43_a 
k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k56_a 
k6l_a 


k75_a 
k76_a 
k79_a 
k80_a 
k81_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 


Names of the RT PC Keys for Japanese English 


Non-English Keyboards 


C-41 


k93 k93_s k93_c -- 

k95 k95_s k95_c k95_a 
k96 k96_s k96_c — 

k97 k97_s k97_c — 

k98 k98_s k98_c — 

k99 k99_s k99_c — 

k100 k100_s k100_c k100_a 
k101 k101_s k101_c 

k102 k102_s k102_c — 

k103 k103_s k103_c _ 

k104 k104_s k104_c k104_a 
k105 k105_s k105_c k105_a 
k106 k106_s k106_c k106_a 
k108 k108_s k108_c k108_a 
k110 k110_s k110_c k110_a 
k112 k112_s k112_c¢c k112_a 
k113 k113_s k113_c¢c k113_a 
k114 k114_s k114_c k114_a 
k115 k115_s k115_¢e k115_a 
k116 k116_s k116_c k116_a 
ELLY k117_s k117_c k117_a 
k118 k118_s k118_c k118_a 
k119 k119_s k119_c k119_a 
k120 k120_s k120_c k120_a 
k121 k121_s k121_c k121_a 
k122 k122_s k122_c k122_a 
k123 k123_s k123_c k123_a 
k124 k124_s k124_¢ k124_a 
k125 k125_s k125_c k125_a 
k126 k126_s k126_c k126_a 


Figure C-9 (Part 3 of 3). Names of the RT PC Keys for Japanese English. The suffix —s refers to the 
Shift key, —c refers to the Ctrl key, a refers to the Alt key, and _g refers to 
the AltGr key. 


Note: The combination control + alternate + another key is not valid. 


C-42 3278/79 Emulation 


Valid RT PC Key Names for Norwegian 


The following pages contain the names of all the recognized RT PC keys for Norwegian. 
Use only the names listed to assign IBM RT PC 3278/79 Emulation functions to RT PC 


keys. 


kl 
k2 
k3 
k4 
k5 
k6 
k7 
k8 
k9 
k10 
k11 
k12 
k13 
k15 
k16 
k17 
k18 
k19 
k20 
k21 
k22 
k23 
k24 
k25 
k26 
k27 


k31 


kl1_s 
k2_s 
k3_s 
k4_s 
k5_s 
k6_s 
k7_s 
k8_s 
k9_s 
k10_s 
k1ll_s 
k12_s 
k15_s 
k16_s 
k17_s 
k18_s 
k19_s 
k20_s 
k21_s 
k22_s 
k23_s 
k24_s 
k25_s 
k26_s 
k27_s 


k31_s 


Figure C-10 (Part 1 of 3). 


kl_c 
k2_¢ 
k3_c 
k4_¢ 
k5_c 
k6_c 
k7_c 
k8_c 
k9_c 
k10_c 
kll_c 
k12_c 
k13_c 
k15_c 
k16_c 
k17_c 
k18_c 
k19_¢ec 
k20_c 
k21_c 
k22_c 
k23_c 
k24_c 
k20.c 
k26_c 
k27_c 
k28_c 
k31_e 


kl_a 
k2_a 
k3_a 
k4_a 
k5_a 
k6_a 
k7_a 
k8_a 
k9_a 
k10_a 
kll_a 
k12_a 
k13_a 
k15_a 
k16_a 
k17_a 
k18_a 
k19_a 
k20_a 
k21_a 
k22_a 
k23_a 
k24_a 
k25_a 
k26_a 
k27_a 
k28_a 
k3l_a 


Names of the RT PC Keys for Norwegian 


Non-English Keyboards 


C-43 





k32 
k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k32_s 
k33_s 
k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 
k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


Figure C-10 (Part 2 of 3). 


C-44 3278/79 Emulation 


k32_c 
k33_c 
k34_c¢c 
k35_c 
k36_c 
k37_c 
k38_c 
k39_c 
k40_c 
k41_c 
k42_c¢ 
k43_c 


k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k5l1_c 
k52_c¢c 
k53_¢e 
k54_c 
k55_c 
k61_c 
k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c¢ 
k84_c¢ 
k85_c 
k86_c 
k89_c 
k90_c 


k32_a 
k33_a 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k41_a 
k42_a 
k43_a 


k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l_a 


k75_a 
k76_a 
k79_a 
k80_a 
k81_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 


Names of the RT PC Keys for Norwegian 





k91 

k92 

k93 

k95 

k96 

k97 

k98 

k99 

k100 
k101 
k102 
k103 
k104 
k105 
k106 
k108 
k110 
k112 
k113 
k114 
k115 
k116 
k117 
k118 
k119 
k120 
k121 
k122 
k123 
k124 
k125 
k126 


k91_s 

k92_s 

k93_s 

k95_s 

k96_s 

k97_s 

k98_s 

k99_s 

k100_s 
k101_s 
k102_s 
k103_s 
k104_s 
k105_s 
k106_s 
k108_s 
k110_s 
k112_s 
k113_s 
k114_s 
k115_s 
k116_s 
k117_s 
k118_s 
k119_s 
k120_s 
k121_s 
k122_s 
k123_s 
k124_s 
k125_s 
k126_s 


Figure C-10 (Part 3 of 3). 


Note: The combination control + alternate + another key is not valid. 


k91_c 

k92_c 

k93_c¢c 

k95_c 

k96_c 

k97_c 

k98_c 

k99_c 

k100_c 
k101_c 
k102_c¢c 
k103_c 
k104_c 
k105_c 
k106_c 
k108_c 
k110_c 
ki12.¢ 
k113_c 
k114_c¢c 
k115_c 
k116_c 
k117_c 
k118_c 
k119_c 
k120_c 
k121_c 
k122_¢ 
k123_c 
k124_c¢ 
k125_c 
k126_c 


k104_a 
k105_a 
k106_a 
k108_a 
k110_a 
k112_a 
k113_a 
k114_a 
k115_a 
k116_a 
k117_a 
k118_a 
k119_a 
k120_a 
k121_a 
k122_a 
k123_a 
k124_a 
k125_a 
k126_a 


Names of the RT PC Keys for Norwegian. The suffix —s refers to the Shift 
key, —c refers to the Ctrl key, —a refers to the Alt key, and _g refers to the 


AltGr key. 


Non-English Keyboards 


C-45 


Valid RT PC Key Names for Portuguese 


The following pages contain the names of all the recognized RT PC keys for Portuguese. 
Use only the names listed to assign IBM RT PC 3278/79 Emulation functions to RT PC 


keys. 


kl k1_s kl_e kl_a — 
k2 k2_s k2_¢ k2_a — 
k3 k3_s k3_c¢ k3_a k3_g 
k4 k4_s k4_c¢ k4_a k4_¢ 
k5 k5_s k5_c k5_a k5_g 
k6 k6_s k6_c k6_a — 
k7 k7_s k7_c k7_a — 
k8 k8_s k8_c k8_a k8_¢g 
k9 k9_s k9_c k9_a k9_¢g 
k10 k10_s k10_c k10_a k10_g 
KILI k1l1_s kll_c kll_a kll_¢ 
k12 k12_s k12_c k12_a — 
k138 k13_s k13_ce¢ k13_a _- 
k15 kl6_s k15_c k15_a — 
k16 k16_s k16_c k1l6_a —- 
k17 k17_s k17_c k17_a _ 
k18 k18_s k18_c k18_a — 
k19 k19_s k19_c k19_a -— 
k20 k20_s k20_c k20_a — 
k21 k21_s k21_c k21_a — 
k22 k22_s k22_¢ k22_a — 
k23 k23_s k23_c k23_a — 
k24 k24_s k24_¢ k24_a -- 
k25 k25_s k25_¢ k25_a -- 
k26 k26_s k26_c k26_a — 
k27 k27_s k27_c k27_a — 
— — k28_c k28_a — 
k31 k81_s k31_c k3l_a — 


Figure C-11 (Part 1 of 3). 


C-46 3278/79 Emulation 


Names of the RT PC Keys for Portuguese 


k32 
k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k32_s 
k33_s 
k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 


k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 
k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


Figure C-11 (Part 2 of 3). 


k32_c 
k33_c 
k34_¢e 
k35_¢c 
k36_c 
k37_c 
k38_c 
k389_c 
k40_c 
k41_e 
k42_¢ 
k43_c 
k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k5l_c 
k52_¢ 
k53_¢ 
k54_¢c 
k55_c 
k61_c 
k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k88_c¢ 
k84_c 
k85_c 
k86_c 
k89_c 
k90_c 


k32_a 
k33_a 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k41_a 
k42_a 
k43_a 
k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l_a 


k75_a 
k76_a 
k79_a 
k80_a 
k81_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 


Names of the RT PC Keys for Portuguese 


Non-English Keyboards 


C-47 


k91 

k92 

k93 

k95 

k96 

k97 

k98 

k99 

k100 
k101 
k102 
k103 
k104 
k105 
k106 
k108 
k110 
k112 
k113 
k114 
k115 
k116 
k117 
k118 
k119 
k120 
k121 
k122 
k123 
k124 
k125 
k126 


k91_s 

k92_s 

k93_s 

k95_s 

k96_s 

k97_s 

k98_s 

k99_s 

k100_s 
k101_s 
k102_s 
k103_s 
k104_s 
k105_s 
k106_s 
k108_s 
k110_s 
k112_s 
k113_s 
k114_s 
k115_s 
k116_s 
k117_s 
k118_s 
k119_s 
k120_s 
k121_s 
k122_s 
k123_s 
k124_s 
k125_s 
k126_s 


Figure C-11 (Part 3 of 3). 


k91_c 

k92_c 

k93_c 

k95_c 

k96_c 

k97_c 

k98_c 

k99_c 

k100_c 
k101_c 
k102_c 
k103_c 
k104_c 
k105_c¢c 
k106_c 
k108_c 
k110_c 
k112_¢c 
k113_c 
k114_c 
k115_c 
k116_c 
k117_c 
k118_c 
k119_c 
k120_c 
k121_c 
k122_¢ 
k123_c¢c 
k124_¢ 
k125_c 
k126_c 


k104_a 
k105_a 
k106_a 
k108_a 
k110_a 
k112_a 
k113_a 
k114_a 
k115_a 
k116_a 
k117_a 
k118_a 
k119_a 
k120_a 
k121_a 
k122_a 
k123_a 
k124_a 
k125_a 
k126_a 


Names of the RT PC Keys for Portuguese. 
Shift key, _c refers to the Ctrl key, —a refers to the Alt key, and _g refers to 
the AltGr key. 


The suffix —s refers to the 


Note: The combination control + alternate + another key is not valid. 


C-48 3278/79 Emulation 


Valid RT PC Key Names for Spanish 


The following pages contain the names of all the recognized RT PC keys for Spanish. Use 
only the names listed to assign IBM RT PC 3278/79 Emulation functions to RT PC keys. 


k1 
k2 
k3 
k4 
k5 
k6 
k7 
k8 
k9 
k10 
k11 
k12 
k13 
k15 
k16 
k17 
k18 
k19 
k20 
k21 
k22 
k23 
k24 
k25 
k26 
k28 
k31 
k32 
k33 


k1_s 
k2_s 
k3_s 
k4_s 
k5_s 
k6_s 
k7_s 
k8_s 
k9_s 
k10_s 
k1l_s 
k12_s 
k13_s 
k15_s 
k16_s 
k17_s 
k18_s 
k19_s 
k20_s 
k21_s 
k22_s 
k23_s 
k24_s 
k25_s 
k26_s 


k28_s 
k31_s 
k32_s 
k33_s 


Figure C-12 (Part 1 of 3). 


kl1_c 

k2_c 

k3_c¢e 

k4_¢ 

k5_c 

k6_c 

k7_c 

k8_c 

k9_c 

k10_c 
kll_c 
k12_¢ 
k13_c 
k15_c 
k16_c 
k17_c 
k18_c 
k19_c 
k20_c 
k21_c 
k22_c 
k23_c 
k24_¢c 
k25_c 
k26_c 
k27_c 
k28_c 
k3l1_c 
k32_c 
k33_c 


kl_a 

k2_a 

k3_a 

k4_a 

k5_a 

k6_a 

k7_a 

k8_a 

k9_a 

k10_a 
kll_a 
k12_a 
k13_a 
k1l5_a 
k16_a 
k17_a 
k18_a 
k19_a 
k20_a 
k21_a 
k22_a 
k23_a 
k24_a 
k25_a 
k26_a 
k27_a 
k28_a 
k3l_a 
k32_a 
k33_a 


Names of the RT PC Keys for Spanish 


Non-Eneclish Kevhnards 


kl_g 


(-49 





k34 
k35 
k36 
k37 
k38 
k39 
k40 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k91 


k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 
k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


k91_s 


Figure C-12 (Part 2 of 3). 


C-AN 3978/79 Emulation 


k34_c 
k35_c 
k36_c 
k37_c 
k38_c 
k389_c 
k40_c 
k41_¢e 
k42_¢ 
k43_c¢c 


k46_c¢c 
k47_c 
k48_c 
k49_c 
k50_c 
k51_c 
k52_c 
k53_c¢c 
k54_c 
k55_c 
k61_c 


k75_e 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 
k84_c¢c 
k85_c 
k86_c 
k89_c 
k90_c 
k91_c 


k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k4l1_a 
k42_a 
k43_a 


k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l_a 
k75_a 
k76_a 
k79_a 
k80_a 
k81l_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 


Names of the RT PC Keys for Spanish 


k92 

k93 

k95 

k96 

k97 

k98 

k99 

k100 
k101 
k102 
k103 
k104 
k105 
k106 
k108 
k110 
k112 
k113 
k114 
k115 
k116 
k117 
k118 
k119 
k120 
k121 
k122 
k123 
k124 
k125 
k126 


k92_s 

k93_s 

k95_s 

k96_s 

k97_s 

k98_s 

k99_s 

k100_s 
k101_s 
k102_s 
k103_s 
k104_s 
k105_s 
k106_s 
k108_s 
k110_s 
k112_s 
k1138_s 
k114_s 
k115_s 
k116_s 
k117_s 
k118_s 
k119_s 
k120_s 
k121_s 
k122_s 
k123_s 
k124_s 
k125_s 
k126_s 


Figure C-12 (Part 3 of 3). 


Note: The combination control + alternate + another key is not valid. 


k92_c 

k93_c¢c 

k95_c 

k96_c 

k97_c 

k98_c 

k99_c 

k100_c 
k101_c 
k102_c 
k103_c 
k104_c 
k105_c 
k106_c 
k108_c 
k110_c 
k112_c 
k113_c 
k114_c 
kil5_c 
k116_c 
k117_c 
k118_c 
k119_c 
k120_c 
k121_c 
k122_c¢ 
k123_c 
k124_c 
k125_c 
k126_c 


k104_a 
k105_a 
k106_a 
k108_a 
k110_a 
k112_a 
k113_a 
k114_a 
k115_a 
k116_a 
k117_a 
k118_a 
k119_a 
k120_a 
k121_a 
k122_a 
k123_a 
k124_a 
k125_a 
k126_a 


Names of the RT PC Keys for Spanish. The suffix —s refers to the Shift 
key, —c refers to the Ctrl key, _a refers to the Alt key, and —_g refers to the 


AltGr key. 


Non-English Keyboards 


C-51 


Valid RT PC Key Names for Swiss-French and Swiss-German 


The following pages contain the names of all the recognized RT PC keys for Swiss-French 
and Swiss-German. Use only the names listed to assign IBM RT PC 3278/79 Emulation 
functions to RT PC keys. 


k1 k1_s kl_e kl_a — 
k2 x28 k2_¢ k2_a k2_¢ 
k3 k3_s k8_e k3_a k3_g 
k4 k4_s k4_c k4_a k4_¢ 
k5 k5_s k5_e k5_a — 
k6 k6_s k6_c k6_a -- 
k7 k7_s k7_c k7_a k7_g 
k8 k8_s k8_c k8_a k8_¢g 
k9 k9_s k9_c k9_a k9_¢g 
k10 k10_s k10_c k10_a — 
k11 k1l_s kll_c kll_a — 
k12 k12_s k12_c k12_a — 
— _. k13_c k13_a _ 
k15 k15_s k15_c k1l5_a — 
k16 k16_s k16_c k16_a _ 
k17 k17_s k17_c k17_a — 
k18 k18_s k18_c k18_a 
k19 k19_s k19_c k19_a -- 
k20 k20_s k20_c k20_a — 
k21 k21_s k21_c k21_a ~- 
k22 k22_s k22_¢ k22_a — 
k23 k23_s k23_¢ k23_a _ 
k24 k24_s k24_¢ k24_a — 
k25 k25_s k25_c k25_a — 
k26 k26_s k26_c k26_a — 
k27 k27_s k27_c k27_a k27_¢ 
- k28_s k28_c k28_a k28_¢ 
k31 k31_s k31_c k3l_a — 


Figure C-13 (Part 1 of 3). 
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k32 
k33 
k34 
k35 
k36 
k37 
k38 
k39 
k40 
k41 
k42 
k43 
k45 
k46 
k47 
k48 
k49 
k50 
k51 
k52 
k53 
k54 
k55 
k61 
k64 
k75 
k76 
k79 
k80 
k81 
k83 
k84 
k85 
k86 
k89 


k32_s 
k33_s 
k34_s 
k35_s 
k36_s 
k37_s 
k38_s 
k39_s 
k40_s 
k41_s 
k42_s 
k43_s 
k45_s 
k46_s 
k47_s 
k48_s 
k49_s 
k50_s 
k51_s 
k52_s 
k53_s 
k54_s 
k55_s 
k61_s 


k75_s 
k76_s 
k79_s 
k80_s 
k81_s 
k83_s 
k84_s 
k85_s 
k86_s 
k89_s 


Figure C-13 (Part 2 of 3). 


k32_c 
k33_c¢c 
k34_c 
k35_c 
k36_c 
k37_c 
k38_c 
k39_c 
k40_c 
k41_c 
k43_c 
k45_c 
k46_c 
k47_c 
k48_c 
k49_c 
k50_c 
k5l_c 
k52_¢c 
k53_c 
k54_c¢c 
k55_c 
k61_c 
k75_c 
k76_c 
k79_c 
k80_c 
k81_c 
k83_c 


k84_¢c. 


k85_c 
k86_c 
k89_c 
k90_c 


k32_a 
k33_a8 
k34_a 
k35_a 
k36_a 
k37_a 
k38_a 
k39_a 
k40_a 
k41_a 


k43_a 
k45_a 
k46_a 
k47_a 
k48_a 
k49_a 
k50_a 
k5l_a 
k52_a 
k53_a 
k54_a 
k55_a 
k6l1_a 
k75_a 
k76_a 
k79_a 
k80_a 
k81_a 
k83_a 
k84_a 
k85_a 
k86_a 
k89_a 
k90_a 
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k91 k91_s k91_c _ 
k92 k92_s k92_c — 
k93 k93_s k93_c = 
k95 k95_s k95_c k95_a 
k96 k96_s k96_c — 
k97 k97_s k97_c — 
k98 k98_s k98_c — 
k99 k99_s k99_c -- 
k100 k100_s k100_c k100_a 
k101 k101_s k101_c — 
k102 k102_s k102_c¢c -- 
k103 k103_s k103_c — 
k104 k104_s k104_c¢c k104_a 
k105 k105_s k105_c k105_a 
k106 k106_s k106_c k106_a 
k108 k108_s k108_c k108_a 
k110 k110_s k110_c k110_a 
k112 k112_s k112_¢ k112_a 
k113 k113_s k113_c k113_a 
k114 k114_s k114_¢ k114_a 
k115 k115_s k115_c k115_a 
k116 k116_s k116_c k116_a 
k117 k117_s k117_c k117_a 
k118 k118_s k118_c k118_a 
k119 k119_s k119_c k119_a 
k120 k120_s k120_c k120_a 
k121 k121_s k121_c k121_a 
k122 k122_s k122_c k122_a 
k123 k123_s k123_c k123_a 
k124 k124_s k124_¢ k124_a 
k125 k125_s k125_¢ k125_a 
k126 k126_s k126_c k126_a 


Figure C-13 (Part 3 of 3). Names of the RT PC Keys for Swiss-French and Swiss-German. The 
suffix _s refers to the Shift key, —c refers to the Ctrl key, —a refers to the Alt 
key, and _g refers to the AltGr key. 


Note: The combination control + alternate + another key is not valid. 
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Duplicate Keys 


The tables of duplicate keys on the following pages show which keys on the IBM RT PC 
Keyboard function as duplicates in each language. 


If you assign different 3278/79 functions to keys listed as duplicates in the duplicate keys 
table, the function assigned to the first key listed in the emdefs.p or emaltdefs.p file 
applies to all of the keys on the line. In other words, the first key on any line to be 
assigned a function in the definition file you are using causes all keys on that line to 
perform that function regardless of any other function they are assigned. 


For example, k32_c and k90_c always have the same function. If in the definition file 


you assign k32_c to terminate the emulator, the duplicate key k90_c also terminates the 
emulator even if it is assigned another function later in the definition file. 
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Duplicate Keys for Austrian/German 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for Austrian/German. 


Keys shown on the same line below perform the same function: 


k2 and k93_s 

k38 and k98_s 

k4 and k103_s 

k5 and k92_s 

k6 and k97_s 

k7 and k102_s 

k8 and k91_s 

k9 and k96_s 

k10 and k101_s 

k11 and k99_s 

k15 and k15_s, k36_c 
k15_c and k126_c, k126_a 
k16 and k24_¢ 

k28 and k106, k106_s 
k82_c and k90_c 

k43_a and k108_a 

k43 and k43_s, k43_c, k52_c, k108, k108_s, k108_c 
k53 and k104_s 

k55 and k105, k105_s 
k61 and k61_s, k61_c, k61_a 
k75 and k75_s 

k76 and k76_s 

k95 and k95_s 

k100 and k100_s 

k110 and k9_c 
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Duplicate Keys for Belgian 


Below are the keys and key combinations that function as duplicate keys and produce 


identical results for Belgian. 


Keys shown on the same line below perform the same function: 


k2_s 
k3_s 
k4_s 
k5_s 
k6_s 
k7_s 
k8_s 
k9_s 
k10_s 
kli_s 
k13 
k15 
k15_c 
k16 
k27 
k28_s 
k32_c 
k40_c 
k43_a 
k53_s 
k54_s 
k55_s 
k61 
k75 
k76 
k110 


and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 


k93_s 
k98_s 


k103_s 


k92_s 
k97_s 


k102_s 


k91_s 
k96_s 


k101_s 


k99_s 


k105, k105_s 
k15_s, k86_c 
k126_c, k126_a 


k24_¢ 
k7_g 


k100, k100_s 


k90_c 


k43, k48_s, k48_c, k108, k108_s, k108_c 
k108_a 

k104_s 

k95, k95_s 

k106, k106_s 

k61_s, k61_c, k61_a 


k75_s 
k76_s 
k27_c 
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Duplicate Keys for Canadian-French 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for Canadian-French. 


Keys shown on the same line below perform the same function: 


k2 
k3 
k4 
k4_s 
k5 
k6 
k7 
k8 
k9 
k9_s 
k10 
k11 
k12 
k13_s 
k15 
k15_¢c 
k16 
k27 
k32_c 
k41 
k43 
k43_a 
k54 
k61 
k75 
k76 
k110 


and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 
and 


k93_s 

k98_s 

k103_s 

k95, k95_s 
k92_s 

k97_s 

k102_s 

k91_s 

k96_s 

k100, k100_s 
k101_s 

k99_s 

k105, k105_s 
k106, k106_s 
k15_s, k86_c 
k126_c, k126_a 
k24_¢ 

k27_s 

k90_c 

k41_s 

k48_s, k48_c, k52_c, k108, k108_s, k108_c 
k108_a 

k54_s, k104_s 
k61_s, k61_c, k61_a 
k75_s 

k76_s 

k27_¢c 
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Duplicate Keys for Danish and Norwegian 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for Danish and Norwegian. 


Keys shown on the same line below perform the same function: 


k2 and k93_s 

k3 and k98_s 

k4 and k103_s 

k5 and k92_s 

k6 and k97_s 

k7 and k102_s 

k8 and k91_s 

k8_s and k95, k95_s 
k9 and k96_s 

k10 and k101_s 

k11 and k99_s 

k12 and k106, k106_s 
k15 and k15_s, k86_c 
k15_c and k126_c, k126_a 
k16 and k24_c¢ 


k32_c and k90_c 
k42_s and k100, k100_s 


k43 and k43_s, k48_c, k52_c, k108, k108_s, k108_c 
k43_a and k108_a 

k53 and k104_s 

k55 and k105, k105_s 

k61 and k61_s, k61_c, k61_a 

k75 and k75_s 

k76 and k76_s 

k110 and k9_c 
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Duplicate Keys for English (UK) 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for English (UK). 


Keys shown on the same line below perform the same function: 


kl_g and k99 


k2 and k93_s 

k3 and k98_s 

k4 and k103_s 

k5 and k92_s 

k6 and k97_s 

k7 and k102_s 

k8 and k91_s 

k9 and k96_s 

k9_s and k100, k100_s 
k10 and k101_s 

k11 and k99_s 

k12 and k105, k105_s 
k13_s and k106, k106_s 
k15 and k15_s, k36_c 
k15_c and k126_c, k126_a 
k16 and k24_¢ 

k32_c and k90_c 

k43 and k43_s, k48_c, k52_c, k108, k108_s, k108_c 
k43_a and k108_a 

k54 and 104_s 

k55_s and k95, k95_s 

k61 and k61_s, k61_c, k61_a 
k75 and k75_s 

k76 and k76_s 

k110 and k27_c 
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Duplicate Keys for Finnish and Swedish 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for Finnish and Swedish. 


Keys shown on the same line below perform the same function: 


k2 and k93_s 

k3 and k98_s 

k4 and k103_s 

k5 and k92_s 

k6 and k97_s 

k7 and k102_s 

k8& and k91_s 

k9 and k96_s 

k10 and k101_s 

k11 and k99_s 

k12 and k106, k106_s 
k15 and k15_s, k36_c 
kld5—c and k126_c, k126_a 
k16 and k24_¢ 

k32_c and k90_c 

k43 and k43_s, k43_c, k52_c, k108, k108_s, k108_c 
k43_a and k108_a 

k53 and k104_s 

k55 and k105, k105_s 
k61 and k61_s, k61_c, k61_a 
k75 and k75_s 

k76 and k76_s 

k95 and k95_s 

k100 and k100_s 

k110 and k9_c 
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Duplicate Keys for French (AZERTY) 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for French (AZERTY). 


Keys shown on the same line below perform the same function: 


k2_s and k93_s 

k8_s and k98_s 

k4_s and k103_s 

k5_s and k92_s 

k6_s and k97_s 

k7 and k105, k105_s 
k7_s and k102_s 

k8_s and k91_s 

k9_s and k96_s 


k10_s and k101_s 
k10_g and k27 

kli_s and k99_s 

k138_s and k106, k106_s 


k15 and k15_s, k36_c 

k15_¢c and k126_c, k126_a 

k16 and k24_¢ 

k32_c and k90_c 

k42 and k100, k100_s 

k43 and k43_s, k48_c, k52_c, k108, k108_s, k108_c 


k43_a and k108_a 
k53_s and k104_s 
k54_s and k95, k95_s 


k61 and k61_s, k61_c, k61_a 
k75 and k75_s 

k76 and k76_s 

k110 and k6_c 
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Duplicate Keys for Italian and Spanish 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for Italian and Spanish. 


Keys shown on the same line below perform the same function: 


k2 and k93_s 

k3 and k98_s 

k4 and k103_s 

k5 and k92_s 

k6 and k97_s 

k7 and k102_s 

k8 and k91_s 

k8_s and k95, k95_s 
k9 and k96_s 

k10 and k101_s 

k11 and k99_s 

k15 and k15_s, k86_c 
k15_c¢ and k126_c, k126_a 
k16 and k24_c¢ 

k28 and k106, k106_s 


k28_s and k100, k100_s 
k32_c and k90_c 


k43 and k43_s, k48_c, k52_c, k108, k108_s, k108_c 
k43_a and k108_a 

k54 and k104_s 

k55 and k105, k105_s 

k61 and k61_s, k61_c, k61_a 

k75 and k75_s 

k76 and k76_s 

k110 and k27_c 
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Duplicate Keys for Japanese English 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for Japanese English. 


Keys shown on the same line below perform the same function: 


k2 and 
k3 and 
k4 and 
k5 and 
k6 and 
k7 and 
k8 and 
k9 and 
k10 and 
k1ll_s and 
k12 and 
k15 and 
k15_c and 
k16 and 
k32_c and 
k40_s and 
k41_s and 
k43 and 
k43_a and 
k54 and 
k55 and 
k61 and 
k75 and 
k76 and 
k110 and 


k93_s 

k98_s 

k103_s 

k92_s 

k97_s 

k102_s 

k91_s 

k96_s 

k101_s 

k99_s 

k105, k105_s 
k15_s, k36_c 
k126_c, k126_a 
k24_¢ 

k90_c 

k106, k106_s 
k100, k100_s 
k43_s, k43_c, k52_c, k108, k108_s, k108_c 
k108_a 

k104_s 

k95, k95_s 
k61_s, k61_c, k61_a 
k75_s 

k76_s 

k28_c¢c 
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Duplicate Keys for Portuguese 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for Portuguese. 


Keys shown on the same line below perform the same function: 


k2 and k93_s 

k3 and k98_s 

k4 and k103_s 

k5 and k92_s 

k6 and k97_s 

k7 and k102_s 

k8 and k91_s 

k8_s and k95, k95_s 
k9 and k96_s 

k10 and k101_s 

k11 and k99_s 

k15 and k15_s, k86_c 
k15_c and k126_c, k126_a 
k16 and k24_c¢ 

k27 and k106, k106_s 


k27_s and k100, k100_s 
k32_c and k90_c 


k43 and k43_s, k48_c, k52_c, k108, k108_s, k108_c 
k43_a and k108_a 

k54 and k104_s 

k55 and k105, k105_s 

k61 and k61_s, k61_c, k61_a 

k75 and k75_s 

k76 and k76_s 


k110 and k9_c 
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Duplicate Keys for Swiss-French and Swiss-German 


Below are the keys and key combinations that function as duplicate keys and produce 
identical results for Swiss-French and Swiss-German. 


Keys shown on the same line below perform the same function: 


k2 and k93_s 

k2_s and k106, k106_s 
k3 and k98_s 

k4 and k103_s 

k4_s and k100, k100_s 
k5 and k92_s 

k6 and k97_s 

k7 and k102_s 

k8 and k91_s 

k8_s and k95, k95_s 

k9 and k96_s 

k10 and k101_s 

k11 and k99_s 

k15 and k15_s, k386_c 
k15_¢c and k126_c, k126_a 
k16 and k24_¢c 

k32_¢c and k90_c 

k43 and k43_s, k48_c, k52_c, k108, k108_s, k108_c 
k43_a and k108_a 

k54 and k104_s 

k55 and k105, k105_s 
k61 and k61_s, k61_c, k61_a 
k75 and k75_s 

k76 and k76_s 

k110 and k27_c 
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Emulation 


Driver Interfaces D-1 
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About This Appendix 


Two device drivers operate between the RT PC and the IBM 
Personal Computer 3278/79 Emulation Adapter: a 3278/79 
Emulation AIX Operating System driver and a 3278/79 Emulation 
Virtual Resource Manager (VRM) driver. 


This appendix describes the interfaces to these drivers. 
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3278/79 Emulation AIX Operating System Driver 
Interface 


Five standard system calls for the AIX Operating System, 
supported by IBM RT PC 3278/79 Emulation, manipulate the 
devices defined to the RT PC: 


open 
close 
read 
write 
ioctl 


This appendix provides information about the system calls that you 
need to use the AIX Operating System driver. This information 
includes a description of 10 ioctl requests specific to 3278/79 


Emulation: 
EMKEY EMWAIT 
EMCPOS EMVISND 
EMSTAT EMIMASK 
EMXPOR IOCTYPE 
EMNWAIT IOCINFO 


Ioctl calls are sent to the AIX driver, which then issues a 
supervisor call (SVC) to the VRM driver. 


For a description of the I/O instructions that use this information, 
see AIX Operating System Technical Reference. 


Note: In this appendix, kfd is used as a sample name for the 


emulation device. This name is only an example; you can use any 
valid name instead. 
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open 


Purpose: 


Syntax: 


Example: 


Description: 


Opens a file for reading and writing. 


For syntax and other information on the open call, see "System Calls" in 
AIX Operating System Technical Reference. 


The example below opens the emulation device for reading and writing: 
#include <fcntl.h> 


ft: Kfa: 
kfd = open("/dev/em78" ,O_RDWR) ; 


You must open the emulation device for both reading and writing. 


Global #define statements for the “O” flags (for example, O_RDWR) are in 
/usr/include/fentl.h. 


The device can be opened by only one user at a time. Multiple open calls 


issued by different processes with the same user ID are allowed, but any 
open issued by a process with a different user ID will fail. 
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close 


Purpose: 


Syntax: 


Example: 


Description: 


Closes a file. 


For syntax and other information on the close call, see "System Calls" in 
AIX Operating System Technical Reference. 


The example below closes the emulation device: 


ine KTAS 
close (kfd); 


Assume kfd contains the file descriptor for the emulation device. 


There are no special considerations for 3278/79 Emulation. 
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read 


Purpose: 


Syntax: 


Example: 


Description: 


Reads from a file. 


For syntax and other information on read and Iseek, see "System Calls" 
in AIX Operating System Technical Reference. 


The example below uses lseek() to move the read file-pointer: 


int kfd; 
char *buff; 
int len; 


int offset; 
int numrd; 


lseek (kfd, (long) offset, 0); 
numrd = read (kfd, buff, len); 


This example reads len bytes from offset in the emulation buffer into the 
user area pointed to by buff. The ]seek() statement sets the offset into 
the communications buffer from which to read. 


Assume kfd contains the file descriptor for the emulation device. 
Two ioctl calls control the way read operates: 


e EMNWAIT indicates that subsequent read calls should be satisfied 
immediately. 


e EMWAIT indicates that read calls should be satisfied only after an 
indication from the control unit that something has changed on the 
display. If the indication is a “buffer modification complete” interrupt, 
read returns the number of bytes requested. If the indication is a “load 
I/O address command decoded” interrupt, read returns 0 for the 
number of bytes read. 
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write 


Purpose: 


Syntax: 


Example: 


Description: 


Writes to a file. 


For syntax and other information on write and lseek, see "System Calls" 
in AIX Operating System Technical Reference. 


The example below uses an Iseek() to move the write file-pointer: 


int kfd; 
char *buff; 
int len; 


int offset; 
int numwr; 


lseek (kfd, (long) offset, 0); 
numwr = write (kfd, buff, len); 


This example writes len bytes from the user area pointed to by buff to 
offset in the emulation buffer. The ]lseek statement sets the offset into 
the communications buffer to begin to write. 


Assume kfd contains the file descriptor for the emulation device. 


There are no special considerations for 3278/79 Emulation. 
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ioctl 


Purpose: 


Syntax: 


Examples: 


Controls input/output devices. 


For syntax and other information on ioctl calls, see "System Calls" in 
AIX Operating System Technical Reference. 


In the following examples, assume kfd contains the file descriptor for the 
emulation device. 


e To send a scan code to the emulation adapter: 
#include <sys/em/78dd.h> 


unsigned int scode; 
int kfd; 
ioctl] (kfd, EMKEY | scode); 


e To get the position of the display cursor: 
#include <sys/em/8dd.h> 
int data; 
int kfd; 
ioctl] (kfd, EMCPOS, &data); 


The data returned is the position of the cursor relative to the start of 
the communication buffer. 
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ioctl 


e To get the current value of the interrupt/status register: 
#include <sys/em/8dd.h> 


int stat; 

int kfd; 

ioctl] (kfd, EMSTAT, &stat); 
The status returned is the eight-bit interrupt status from the adapter 
status register. The definition of these bits is discussed in JBM 
Personal Computer 8278/79 Emulation Adapter Technical Reference. 


e To execute a power-on reset of the emulation adapter: 
#include <sys/em78dd.h> 


int kfd; 
ioctl] (kfd, EMXPOR); 


e To indicate that read() calls should be satisfied immediately: 
#include <sys/em78dd.h> 


int kfd; 
ioct] (kfd, EMNWAIT); 


e To wait for a change to the emulation buffer or cursor position before 
satisfying a read(): 


#include <sys/em78dd.h> 


int kfd; 
ioctl] (kfd, EMWAIT); 
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ioctl 


To get the current contents of the emulation visual/sound register: 
#include <sys/em/8dd.h> 


int vsdata; 
ioctl] (kfd, EMVISND, &vsdata) ; 


To mask communication adapter interrupts that appear at the Virtual 
Machine Interface (VMI): 


#include <sys/em/8dd.h> 


int kid: 
int mask; 
ioctl] (kfd, EMIMASK, &mask) ; 


This ioctl provides a mask to specify which interrupts appear at the 


The low-order bits of the mask (0 - 7) correspond to bits 0 - 7 of the 
interrupt status register. Bits 8 - 15 of the mask correspond to bits 0 - 7 
of the visual/sound register. When a bit is on, the interrupt that 
corresponds to that bit position appears at the VMI. Interrupts that 
correspond to off (0) bit positions in the mask are discarded at the 
VRM level. The previous mask setting is returned to the caller in 
mask. 


The interrupt status bits and the visual/sound bits are documented in 
AIX Operating System Technical Reference. 
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ioctl 


To return a byte indicating the device type: 


#include <sys/ioctl.h> 
#include <sys/devinfo.h> 


unsigned char devtype; 
devtype = ioctl (kfd, IOCTYPE); 


For 3278/79 emulation, the device type is DD_EM78, as defined in 
devinfo.h. 


To copy the devinfo structure to the user specified area: 


#include <sys/devinfo.h> 
#include <sys/ioctl.h> 


Struct devinfo info; 
joct] (kfd, IOCINFO, &info); 


Returns a structure of device information (devinfo) to the user 
specified area. 


As defined in devinfo.h, the devtype field is DD_EM78, and the flags 
field is 0. 


D-12 3278/79 Emulation 


3278/79 Emulation Virtual Resource Manager (VRM) 
Driver Interface 


The Virtual Resource Manager (VRM) driver operates between the 
Virtual Machine Interface and the IBM Personal Computer 3278/79 
Emulation Adapter to process data, status, and interrupts. 


The VRM driver provides a queued interface to a hardware device. 
The driver accepts commands from a higher level, either the device 
manager or the operating system itself, and generates the required 
I/O instructions to the adapter. 


The VRM driver is also responsible for handling interrupts from a 
hardware device, usually for I/O completion or exception 
conditions. 


The interface to VRM is through a supervisor call (SVC) from the 
AIX Operating System driver. Requests enter a queue and are 
accessed as required for 3278/79 Emulation. 


The routines associated with the VRM driver are: 


Define Device 

Initialization 

I/O Initiation 

Second Level Interrupt Handler (SLIH) 
Exception Handler 

Termination. 


Information required to use the 3278/79 Emulation VRM driver is 
shown on the following pages. See the Virtual Resource Manager 
Technical Reference for a description of the I/O instructions that 
use this information. 
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Define Device Header 


The Define Device Header section of the Define Device Structure 
(DDS) is common to all VRM drivers. The Define Device Header 
contains the information shown below: 


byte O " 
IODN IOCN 
4 
Define Options Device Type 

8 
16 

Offset to Hardware Characteristics 
20 


Offset to Device Characteristics 


31 bits 





! Hardware Characteristics | 
{__________| Device 
Device Characteristics | »Dependent 

| | Information 
| ! 
| | 


RAS Error Log 


The parameters specific to 3278/79 Emulation are defined as 
follows: 


IODN 
The 16-bit I/O Device Number the I/O subsystem (IOS) uses 
to reference this device for I/O activity. The IODN for 
3278/79 Emulation is assigned by the system. 


IOCN 
The 16-bit I/O Code Number used to link the emulation 
adapter to the code that supports it. The IOCN for 3278/79 
Emulation is assigned by the system. 


Define Options 
The 16-bit field that indicates the requested device definition 
option. Set to 1 if you plan to add a device to the system, or 
2 if you plan to delete a device from the system. 
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Device Type 
The 16-bit field that indicates characteristics of the device 
being defined. For 3278/79 Emulation, this field is set to 
Ox01. 


Device Name 
The 32-bit field that stores a name for the device that uses 
this driver. For 3278/79 Emulation, the value is em78 
(ASCII). 


Offset to Hardware Characteristics 
A 32-bit field that specifies the byte offset from the start of 
the DDS to the device Hardware Characteristics. For the 
3278/79 Emulation VRM driver, the offset is 28 bytes. 


Offset to Device Characteristics 
A 32-bit field that specifies the byte offset from the start of 
the DDS to the Device Characteristics. For the 3278/79 
Emulation VRM driver, the value is 0 bytes, to indicate that 
the driver has no Device Characteristics section. 


Offset to RAS Error Log 
A 32-bit field that specifies the byte offset from the start of 
the Define Device Structure to the RAS Error Log. For the 
3278/79 Emulation VRM driver, this value is 72 bytes. 


Device Dependent Information 
These fields are variable in length, and contain the device 
Hardware Characteristics, Device Characteristics, and RAS 
Error Log. Each of these 3 fields starts on a word boundary. 
The first 4 bytes in each of the fields is the section length in 
words. 


The Device Dependent Information contains three variable-length 


fields. These fields — Hardware Characteristics, Device 
Characteristics, and RAS Error log — are described next. 
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Hardware Characteristics 


The parameters that describe the Hardware Characteristics are: 

















0 
DDS Header 
28 
Length (in words) of Hardware Characteristics 
32 
Internal device type 
a I/O port address (base) 
- I/O port addresses (number) 
Bus memory start address (RAM) 
a Bus memory end address (RAM) 
ne DMA type 
ap One interrupt definition (16 bytes) 
for each interrupt level supported 
y the device 
N 
Nad Bus memory start address (ROM) 
+ 
Bus memory end address (ROM) 
N+8 


These 32-bit parameters are defined as follows: 


DDS Header 
See “Define Device Header” on page D-14. 


Length 


Specifies the length in words. For the 3278/79 Emulation 
VRM Driver, this value is 11 words. 
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Internal Device Type 
Specifies the type of device. For the 3278/79 Emulation 
VRM driver the format of this field is: 


to 16 25 24 


i]s fo 3] #Int = 1 Slot Number | Adapter Type | Port Number 
1 (Ox01) 
92 (0x54) 


Device width = 8 bit 
switchable to co-processor 
I/O bus device 


I/O Port Address (Base) 
Contains the base I/O port address for the 3278/79 Emulation 
adapter. The value is 0xF00002D0. 


I/O Port Address (Number) 
Contains the number of I/O ports. For the 3278/79 
Emulation adapter this value is 0x0A. 


Bus Memory Start Address 
The address is 0xF40CE000. 


Bus Memory End Address 
The address is 0x F40CEFFF. 


DMA Type 
Specifies the device Direct Memory Access support. For the 
3278/79 Emulation VRM Driver, the format of this field is: 


0125 49 6/7 235 24 


| | a | on 


Device does not support DMA 
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Interrupt Type 
Specifies the device interrupt support. For the 3278/79 
Emulation VRM Driver, the format of this field is: 


Note: The interrupt level field is always 0x09, and the class 
field is always 0x02. 


Go 1 23 16 235 24 ot 








9 (Ox09) 


2 (0x02) 


Non-sharable interrupts 


Enable device interrupts 


Device Characteristics 


The device characteristics section in the DDS describes how an 
adapter is to be configured at initialization time. The 3278/79 
Emulation VRM driver has no device characteristics section since 
the adapter is not configured at initialization. 


Error Log 


The error log section of the DDS contains error information. The 
only error logged by the 3278/79 Emulation VRM driver is for a 
lack of response from the control unit within 30 seconds of a send 
keystroke command from the AIX Operating System driver. This 
condition can be caused by control unit inactivity, adapter failure, 
or cable failure. See “Error Log” on page B-4. 
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Command Control Block 


The Command Control Block (CCB) contains the information 
necessary to start an I/O transfer or command. The CCB is 
composed of two parts: the Command Header and Command 
Elements. For data transfer, there must be one Command Element 
for each data transfer area. The Command Header and Command 
Elements that define an I/O operation must be contiguous in 
storage. Chaining capability is provided by the Link Bit shown in 
the Command Element structure. 


Command Header 


The Command Header contains 24 bytes of general information 
about the I/O operation and must be aligned on a full word 
boundary. 


0 1 31 bit 


6 
0 
esenes | ON 
2 3278/79 Device Dependent Parms 









General 
12; ; \ Device 
! Reserved | Dependent 
Parameters 
l | 
byte 24 


The fields in the Command Header are: 


Operation Options: The Operation Options field contains flags 
describing the current operation. 


Bit 31 Interrupt on completion 
Bit 30 Interrupt on error 

Bit 29 Synchronous operation 
Bit 28 Command elements follow 
Bit 27 Reserved for VRM 
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Bit 16 to 26 Device options 


The valid device options for the 3278/79 Emulation VRM driver are 
as follows. These values occupy the lower-order 8 bits of the 
Device Options field (bits 26 through 19). The AIX device driver 
puts zeroes into the remaining high-order 3 bits of the Device 
Options field (bits 18, 17, and 16). 


0x00 = read data 
Transmits data from the 3278/79 Emulation Adapter 
buffer to the system buffer. Has an associated 
Device-Dependent Parameter (see page D-21). 

0x01 = write data 
Transmits data from the system buffer to the 3278/79 
Emulation Adapter buffer. Has an associated 
Device-Dependent Parameter (see page D-21). 

0x02 = position 
Not used for this driver. 

0x03 = format 
Not used for this driver. 

0x04 = control 
Not used for this driver. 


0x05 = open 
Creates a physical connection to a control unit. 
0x06 = close 


Terminates the physical connection to a control unit. 
0x07 = send scan code 

Sends a keystroke to the control unit. Has an 

associated Device-Dependent Parameter (see page D-21). 
0x08 = return adapter status 

Returns adapter status to the operating system. Has an 

associated Device-Dependent Parameter (see page D-21). 
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0x09 = return cursor position 
Returns cursor position to the operating system. Has 
an associated Device-Dependent Parameter (see page 
D-21). 

Ox0OA = set masks 
Sets mask values for the adapter interrupt status 
register and the visual/sound register. Returns previous 
values of the masks. (See “set masks” on page D-33 for 
more information.) Has an associated 
Device-Dependent Parameter (see page D-21). 

0x0OB = execute power-on reset 
Executes the power-on reset (POR) sequence for the 
emulation adapter. 


IODN: The IODN field contains the 16-bit identifier for the 
specified I/O device. 


Device-Dependent Parameters: In general in the AIX Operating 
System, device-dependent parameters occupy bytes 8 through 23 of 
the Command Header. For 3278/79 Emulation in particular, 
device-dependent parameters occupy only part of this area: the 
highest-order halfword. 


Most of the RT PC 3278/79 Emulation device-dependent parameters 
are 16 bits long, thus filling up all of their allotted space. 
However, some of the 3278/79 Emulation device-dependent 
parameters are 8 bits long. These 8-bit values must be aligned on 
the high-order word boundary of the Device-Dependent Parameter 
area; any remaining low-order bits are ignored. 
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Several of the 3278/79 Emulation device options have 
device-dependent parameters: 


Device Option Device-Dependent Parameter 


Open None 

Close None 

Read data Offset into communications buffer (16 bits) 
Write data Offset into communications buffer (16 bits) 
Send scan code Keystroke (8 bits) 


Return adapter status Status (8 bits) 
Return cursor position Cursor position (16 bits) 
Execute power-on reset None 


Set masks Mask values (2 x 8 bits) 


D-22 3278/79 Emulation 





Command Elements 
A command element defines an area of system memory for data 


transfer. The format of each command element is shown in the 
following illustration: 
31 bit 


) ibs. 


Data Transfer Length 


Memory Address 


The fields in a command element are: 










12 





byte 16 


Link (L) 
1-bit field (the bit in position 15) that indicates the end 
of the chain when the bit is set to zero. 


Data Transfer Length 
32-bit field that contains the length in bytes of the data 
to be transferred. 

Memory Address 
32-bit field that contains the address of the area used 
for the I/O transfer. 

The Link field is set to zero for all 3278/79 Emulation commands. 


Both the read data and write data commands require a Data 
Transfer Length and a Memory Address. 
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Command Device Options 


The next few pages explain the commands to the I/O Initiate VRM routine. These 
correspond to the 3278/79 Emulation device options (part of the Operation Options field in 
the Command Header). For more information about these commands, see the chapter 
about system control instructions in Virtual Resource Manager Technical Reference. 
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open 


Purpose: 


Parameters: 


Description: 


Tests for the presence of the adapter, initializes the adapter, initializes the 
interrupt status register mask and visual/sound register mask to OxFF, 
enables interrupts, and enables the physical connection to the control 
unit. 


Operation Option: 0xC005 


The command header looks like this: 


| Reserved | 0xC005 
‘| Reserved | IODN 
e] Reserved 
e{ Reserved 
{Reserved 
{Reserved 


24 





The open command does not take a command element. open ignores any 
command element passed to it. 


Return Codes: 


0x0000 Completed successfully 

0x8027 Device handler already open. 

0x8028 Device handler not open. The adapter may not be properly 
installed. 
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close 


Purpose: 


Parameters: 


Description: 


Return Codes: 


Terminates the physical connection with the control unit. 
Operation Option: 0xC006 


The command header looks like this: 


The close command generally is not executed until all previous 
commands are dequeued/acknowledged or canceled. 








The virtual machine should issue a cancel_I/O supervisor call before 
issuing a close command. This ensures that there are no pending I/O 
queue elements. 


The close command does not take a command element. close ignores any 
command element passed to it. 


0x0000 Completed successfully 
0x8028 Device handler not open. 
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read data 


Purpose: 


Parameters: 


Description: 


Return Codes: 


Reads data from the communications buffer into system memory. 
Operation Option: 0xD000 


The command header (bytes 0 through 23) and command element (bytes 24 
through 39) look like this: 


Reserved 


The command element contains the address of the system buffer. 







12 






16 






20 






24 






28 





32 





36 





40 


Bytes 8 and 9 of the command header should contain the offset into the 
communications buffer. 


The sum of the transfer length and the offset to the adapter buffer must 
not exceed 4096 bytes. 


0x0000 Completed successfully. 
0x8025 Adapter offset and/or transfer length out of range. 
0x8028 Device handler not open. 
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write data 


Purpose: Writes data from system memory to the communications buffer. 
Parameters: Operation Option: 0xD001 


The command header (bytes 0 through 23) and command element (bytes 24 
through 39) look like this: 


' 
at Reserved 
se] Reserved 
ey Reserved 
: 
“| Data Transfer Length 
| System Buffer Address 
ep Reserved 


40 





Description: The command element contains the address of the system buffer. 


Bytes 8 and 9 of the command header should contain the offset into the 
communications buffer. 


The sum of the transfer length and the offset to the adapter buffer must 
not exceed 4096 bytes. 


Return Codes: 
0x0000 Completed successfully. 


0x8025 Adapter offset and/or transfer length out of range. 
0x8028 Device handler not open. 
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send scan code 


Purpose: 


Parameters: 


Description: 


Return Codes: 


Sends a keystroke from the system to the control unit. 
Operation Option: 0xC007 


The command header looks like this: 








The send scan code command does not require a command element. 
send scan code ignores any command element passed to it. 


Byte 8 of the command header should contain the 3270 scan code to be 
sent to the control unit. 


0x0000 Completed successfully. 
0x8028 Device handler not open. 
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return cursor position 


Purpose: 


Parameters: 


Description: 


Return Codes: 


Tells the device handler to read the adapter cursor-address register and 
transfer the address to the system. 


Operation Option: 0x2009 


The command header looks like this: 







12 






16 






20 





24 


The return cursor position command does not require a command 
element. return cursor position ignores any command element passed 
to it. 


Upon completion of this command, byte 8 of the command header 
contains the high-order byte, and byte 9 contains the low-order byte of 
the adapter cursor-address register. 


0x0000 Completed successfully. 
0x8028 Device handler not open. 
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return status 


Purpose: 


Parameters: 


Description: 


Return Codes: 


Tells the device handler to read the adapter status register and transfer 
the status to the system. 


Operation Option: 0x2008 


The command header looks like this: 


Reserved 0x2008 
IODN 


Reserved 
Reserved 
Reserved 





The return status command does not require a command element. 
return status ignores any command element passed to it. 


Upon completion of this command, byte 8 of the command header 
contains the contents of the adapter interrupt-status register. 


0x0000 Completed successfully. 
0x8028 Device handler not open. 
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execute power-on reset 


Purpose: 


Parameters: 


Description: 


Return Codes: 


Tells the device handler to disable the cable, reinitialize the adapter 
registers, and then enable the cable. 


Operation Option: O0xCO00B 


The command header looks like this: 







12 






16 






20 





40 


The execute power-on reset command does not require a command 
element. execute power-on reset ignores any command element passed 
to it. 


0x0000 Completed successfully. 
0x8028 Device handler not open. 
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set masks 


Purpose: 


Parameters: 


Description: 


Return Codes: 


Tells the device handler to accept new mask values for the interrupt 
status register and visual/sound register. 


Operation Option: 0x200A 


The command header looks like this: 


[Reserved 
: 
of CRewerved 
o|——~Rewerved 
so 
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The mask values determine which real adapter interrupts are returned to 
the operating system as virtual interrupts. Byte 8 of the command header 
contains the mask value for the visual/sound register, and byte 9 contains 
the mask value for the interrupt status register. Bit values of zero in the 
masks indicate that those adapter interrupts are not to be passed to the 
virtual machine as virtual interrupts. 


The set masks command does not require a command element. set 
masks ignores any command element passed to it. 


Both masks are set to 0xFF when an open is performed. Upon 


completion of set masks, the previous values of the masks are returned 
in bytes 8 and 9 of the command header. 


0x0000 Completed successfully. 
0x8028 Device handler not open. 
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Second Level Interrupt Handler (SLIH) 


Upon entry, the Second Level Interrupt Handler (SLIH) disables the adapter interrupts. 
The adapter continues to update status-register bits, and the SLIH processes all the 
interrupt bits that are set. The SLIH then re-enables the adapter interrupts and returns to 
the VRM. 


Because the adapter interrupts are disabled, bit 7, the interrupt-generated bit, is not set 
with the other bits and the status field of the virtual machine’s program-status block does 
not show bit 7 on when a virtual interrupt occurs. The 3278/79 Emulation AIX Operating 
System device driver ignores bit 7 in evaluating the cause of the virtual interrupt. 


For more information about virtual interrupts, refer to “set masks” on page D-33. For 


information about adapter interrupts, refer to [BM Personal Computer 3278/79 Emulation 
Adapter Technical Reference. 


D-34 3278/79 Emulation 


Appendix E. File Transfer Application Program 
Interface (API) 


File Transfer API E-1 
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About This Appendix 


This appendix provides information to help programmers integrate 
File Transfer utilities into application programs. 
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Introduction 


You can write an application program that integrates the File 
Transfer utilities into its structure. Then, File Transfer can be 
invoked and terminated directly from the application. This 
application can include a new user interface. 


The following AIX Operating System facilities can be used to build 
and modify the application: 


AIX Operating System Driver 

Virtual Resource Manager (VRM) Driver 
Interprocess Communications (IPC) 
General Queueing Mechanism 


File Transfer Error Handling. 


The AIX Operating System and VRM driver interfaces are 
discussed in Appendix C. The other facilities are discussed in this 
appendix. 
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Interprocess Communication (IPC) 


The AIX Operating System provides several Interprocess 
Communication (IPC) facilities for communication between 
processes in an application. These facilities include signals, 
semaphores, and message queues. 

The following example shows one way to use signals in File 
Transfer. During 3278/79 Emulation, processes communicate with 
signals. A user or an application can use the signal handlers in 
the File Transfer utilities to interrupt the process. The procedure 
is as follows: 

1. File Transfer utilities receive SIGTERM, the terminate signal. 
2. File Transfer stops. 

3. IND$FILE, the host file transfer program, is reset. 

4. The process exits. 


The killQ) system call generates the interrupt signal just described, 
using the process_id (PID) of the File Transfer program. 


#include <sys/signal.h> 
int pid,SIGTERM; 
kill (pid,SIGTERM) ; 


Other signals and system calls can be used to invoke file transfer. 
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Process Queueing 


The AIX Operating System supports a general-purpose 
process-queueing facility in the print command. When the print 
command places a File Transfer command on a queue, the 
following advantages are realized: 


Process queueing permits time-consuming processes to run in 
the background, thus sharing limited computer resources and 
eliminating the time a user must wait for one process to execute 
before another can begin. 


The sequential queueing of processes on the same queue 
resolves contention for any resources that cannot be shared. 
Since the IBM Personal Computer 3278/79 Emulation Adapter is 
not a shareable device, the queue ensures that only one process 
tries to use the adapter at a time. 


To use the print command for process queueing, you must: 


1. 


2. 


E-6 3278/79 Emulation 


Identify a new queue to the qdaemon. 


Place requests on the queue by issuing the print command. 


Identifying a New Queue 


To identify a new queue, edit the /etc/qconfig file as described in 
AIX Operating System Technical Reference. The example given 
below shows how to: 


e Add new stanzas to the file to identify -xfr, a new queue. 


e Describe backend, the background program that executes when 
a request is placed in the -xfr queue. 


In this example, the background program is the shell and two 
backends are described, one for emsend (/usr/bin/sendshell) and 
one for emrcv (/usr/bin/revshell). An example of a shell program 
is given later in this topic. 


The adapter cannot be used by more than one process at a time. 
Because the emsend and emrcev commands are placed on the same 
queue, contention for the adapter is resolved. 


eT: 
argname = -xfr 
device = send,rcv 
friend = FALSE 
send: 
backend = /usr/bin/sendshel] | 
file = /tmp/emsend. log 
rcv: 


backend = /usr/bin/rcvshel | 
file = /tmp/emrcv.log 


File Transfer API E-7 





An example of a shell procedure that issues the emsend command 
is: 


emsend -f$1 -V"$1 data a (TEXT" 2>&1 


This example follows the general syntax described in “emsend 
(VM/CMS)” on page 3-7. The $1 file is sent to the host and stored 
as an EBCDIC file named $1 of type data and mode a. 


Usually multiple programs from different queues can execute at the 
same time, since the qdaemon redirects standard output and 
standard error to the /dev/nulli file. When this happens, status 
information, such as error messages and return codes, is lost. 


The shell procedure in the above example catches the status 
information. A shell procedure can perform various administrative 
functions, including logging the status of requests, retrying file 
transfer if recovery from a failure is possible, and communicating 
with an application using Interprocess Communication (IPC). 


For information on queue management and writing shell 


procedures, refer to AIX Operating System Technical Reference and 
AIX Operating System Programming Tools and Interfaces. 
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Placing Requests on the Queue 
Once the queue is created, requests can be placed on the queue by 
issuing the print command. The command may be issued two 
ways: 
e The user can type the command on the command line. 


e The application program can issue an exec() system call. 


An example of a user-typed command is: 


print -xfr:0 myfile 


1. The print command places a request on the -xfr queue to 
execute the first backend described in the file. 


2. The argument myfile is passed to the backend. 


38. The user-supplied shell procedure, /usr/bin/sendshell, formats 
an emsend command with the required parameters. 


4. The emsend command executes. 


5. Standard output (stdout) and standard error (stderr) are 
redirected to the /tmp/emsend.log file. 


Usually the qdaemon discards stdout and stderr. Because a 
file parameter is specified in the stanza for this backend, stdout 
and stderr are logged. 


Note: The file specified in the xfr: stanza of /etc/qconfig 
must already exist for this redirection to take place. 


6. The return code from emsend is returned to the shell procedure 
to be processed as required. 
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Error Handling 


The File Transfer utilities can implement several procedures if a 
problem occurs when an emsend or emrcv command is issued. 
These procedures include: 


e Checksum validation of data sent and received from the host 

e Command line parsing 

e Retries when invalid data is received 

e Host file transfer protocol. 

If the File Transfer utility recovers from the error, the application 
receives a return code of zero, indicating successful completion of 
the command. If the utility cannot recover, the application 
receives a return code other than zero. 

You may need to modify your application program to resolve some 
problems. The following table contains information that can help 


you do this, including the return codes, bit positions (numbering 
from right to left), and a description of each problem. 
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Return | Bit 
Code Position | Description | 


‘a se f Successful completion of emsend or emrcv 


02 Host Message: The host has sent an error message which has caused 
emsend or emrcv to terminate. This error message will appear in stderr. 





01 Time out. Host did not respond in the required time. 
An em78 error. An error occurred with the hardware or the de, ice driver. 
04 Frame Sequence Error. Data found in the host data frame could not be 
interpreted. 

16 05 Host Request for Termination. The host application (IND$FILE) 
encountered an error and requested the work station to terminate the 
session. 

2 


3 


Signal Condition. A signal received from the keyboard or another process 
in the work station requested that emsend or emrcv terminate. 


64 07 Signal Error. Hardware error prevented establishing a session with the 
host. May be caused by a bad adapter card or a disconnected cable. 

128 Lock Already Set. Another process is using the device, and the file 
transfer process cannot use it. 

256 Command Line Syntax Error. An error occurred in parsing the file 
transfer command line in the work station. 

512 10 Local File Access Error. File system permissions do not allow access to 
the file you want to send or receive. 

1024 11 Local File Read/Write Error. An error encountered at the work station 
prevented reading or writing the file you want to send or receive. 

2048 12 Invalid translation warning. A character or characters could not be 
translated during emrcv. 


File Transfer API E-11 
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Appendix F. Translation During File Transfer for 
AIX Version 1.1 


Translation for AIX Version 1.1 F-1 
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Langunge-to-Code-Page Number CHAE 1. ccc cueew ees ee ueeeeaseeww eeee nee me F-6 
aE, « cease cece eek Ce oP es 650086 3 Ora Oe POOLE EES eo F-7 
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English (US) (TEXT) Two-Byte Values for ASCII to EBCDIC Translation ..... F-25 
EBCDIC to ASCII Translation for English (US) (TEXT) ................... F-26 
eo oe. a a or en a ae er ees F-27 
ASCII to EBCDIC Translation for Finnish and Swedish ................... F-27 
Finnish and Swedish Two-Byte Values for ASCII to EBCDIC Translation ...... F-28 
EBCDIC to ASCII Translation for Finnish and Swedish ................... F-29 
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ASCII to EBCDIC Translation for French (AZERTY) ..................6-- F-30 
French (AZERTY) Two-Byte Values for ASCII to EBCDIC Translation ........ F-31 
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ASCH to EBCDIC Translation for Italian .«....6.c:.64 bee ibiwew ee wie vawewens F-33 


Italian Two-Byte Values for ASCII to EBCDIC Translation ................ F-34 
EBCDIC to ASCII Trinelation for ahah cic ki cies weeks wi Rwae ei eew memes F-35 
SAPAHESS FEHCUSH <i ei ea RARER Haw RARER AERA BEAM ARIK EERE RTRKRBRER EGS F-36 
ASCII to EBCDIC Translation for Japanese English ...................... F-36 
Japanese English Two-Byte Values for ASCII to EBCDIC Translation ........ F-37 
EBCDIC to ASCII Translation for Japanese English ..................2005. F-38 
emer Sera ee Fe ee Ee oe Seed i Ha es i te a FOR OO se 98h eS F-39 
ASCII to EBCDIC Translation for Portuguese .......... 0... 0... F-39 
Portuguese Two-Byte Values for ASCII to EBCDIC Translation ............. F-40 
EBCDIC ta ASC ‘Tratielation for Portuguese cn ciniascacterameciesane nies F-41 
POOWGE 464 Kiv bs Oa hE Os se Bowe RE Se ETS ew Rw EE KR ee Rs F-42 
ASCII to ERCDIC Translation foF SPSHIGN. «cnc wiki sac ei eR RK HERDER REDE F-42 
Spanish Two-Byte Values for ASCII to EBCDIC Translation ................ F-43 
EBCDIC to ASCU ‘Translation for Spanish. ..... 0.0.2.0 00 wee neenesumanses F-44 
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About This Appendix 


This appendix is used with Version 1.1 of the AIX Operating 
System only. Version 2.1 of the AIX Operating System uses 
different translation code pages than the Version 1.1. Be sure to 
use Appendix F or Appendix G according to the version you have. 


The pages in this appendix show the translations between ASCII 
and EBCDIC during file transfer for each supported language. 
These tables are specific to the file transfer function of 3278/79 
Emulation. 


The tables in this appendix are listed by language. The 
“Language-to-Code-Page Number Chart” on page F-6 shows the 
Country Extended Code Page (CECP) or the Code Page (CP) for 
each language. 
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About Translation During File Transfer 


Files stored on an RT PC are in ASCII form, while files stored on 
the host are in EBCDIC. Therefore, we recommend using TEXT (or 
ASCII) mode during file transfer. 


If you send an unsupported ASCII character such as a form feed to 
the host, a substitute character will replace the form feed in your 
file. When you copy the file back from EBCDIC to ASCII, the 
ASCII equivalent of the substitute character will appear, not the 
form feed you originally typed. 


Otherwise, when a supported character is translated from EBCDIC 
to ASCII (during emrcv) and then back to EBCDIC (during 
emsend), there is no overall change. 


In the charts and tables of this appendix the following notations 
are used: 


e Numbers that appear in green in the EBCDIC to ASCII tables 
are two-byte values. The first byte of each of these numbers is 
LE 


e A substitute value of 1A for EBCDIC and 3F for ASCII is used 
when the character being sent is not supported. Some 
applications may display a substitute character, but other 
applications may not display anything. 


e On each of the ASCII to EBCDIC tables, the * in 1C, 1D, and 1E 
positions represents a two-byte character. However, the 
substitute value is always used, because none of these 
characters are supported. 


e Also on the ASCII to EBCDIC tables, a * in the 1F position 
represents a two-byte number. Possible values for that number 
are listed in the chart following the ASCII table for each 
country. For any 1F values not listed in the chart, the 
substitute character is used. 
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Language-to-Code-Page Number Chart 

















Language CP Starting on Page 
a a 

(ASCII) 

(TEXT) (modified) 
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Austrian/German 


ASCII to EBCDIC Translation for Austrian/German 


Saeemnee Ta ez maid Second ASCII Digit ke in nee 


Toa as spe] 2] oP ep as] of a] ef 
stole) st stel atl eietelalel ele! =| = 
| s2[ [ve | a] a] - | 

ctatste eteleletels [el =[stel al ale 
rttetetelaatelepala tales pe sla 
rs or] 6) oe res 
Mi erereratatete siete etetetat ale 
aT er] sel sol a2] asl owas] asl ar pas fae | as ee | 0c] so] a7 
Fa] se| cof sx] 2] col o+| «7| ae] se] ss] oe] 7] so] ss] a] 

Pol nm] vel sel col sal cof o6| oo] or [eo] se] so] | se| sr] 
aos] ssl cel oe| el co] on] oo |e far fen] os er] onl | co 
: 
Pol el sel orl al sel orl ae] sear] oe | ar ae | se | orl ae] oe 


Figure F-1. Austrian/German Conversion from ASCII to EBCDIC. All digits are hexadecimal. See 
the notes on page F-5. 














First ASCII Digit 
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Austrian/German Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII EBCDIC ASCII EBCDIC 
1FA0 B3 1FD2 9D 
1FB4 B6 1FD3 9F 
1FB5 7C 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 Al 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 BC 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC ii 1FE1 EE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FD0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure F-2. Austrian/German Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for Austrian/German 


Second EBCDIC_ Digit ——_______ 


Tea 2p, -, =, [7] *)*]s, e]) ep 
re [oof er] ef os | ial oo | on] mr [ vm] al om | | | ow] a | oF 
Pifrof fsa] va) om] os | mse |r fm] ml tm] va] | ow 
pin faa sal te [ sal ono [om [om [oa] ia] om] | os | 7 
ES es EAE 
: res [a0 | 7 [om 












SE 


NO 
—h 


NM | WwW | on 
ee en ee 


62| 63 | 64| 65 | 66 | 67 | 68 | 69 | Ae | AF | or 
slatateleielelaieiaimielats 
rev [ raf 7 | 75] 76] 77 [78 | 7 | m [mo [a8 | oe | 
pec} ep] ao] oF] 40 | 24 | ac | as | 08 | aa | 7c | 09 | on 
sc | or | 50 [51 | se | ve | 96 | 70 | a7 
Doon Sooo oe 


Figure F-3. Austrian/German Conversion from EBCDIC to ASCII. All digits are hexadecimal. See 
the notes on page F-5. 


a 
a‘ 
(©) 
i 


First EBCDIC Digit 


W 0o Co ™ 1 
oO at é Oo Co 





mD 


Boo : 
> > CO wo ww) WG W N 
WN NO Oo NO — CJ Mm W 


Ls 
J 
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Belgian, Swiss-French, Swiss-German 


This code page is used for Swiss-French and Swiss-German, and is the default for Belgian. 


ASCII to EBCDIC Translation for Belgian, Swiss-French, 
Swiss-German 


oneness neni Second ASCII Digit eo 


Tees Tset ef [pele op et 
sefafetstotefa fe fete te fete Tele To 
foo ff 213 [se] x0 [ae fas fe [oe [or far [f+ TT 
aisfeteta{s[elelelel[e [eles ala 
tetefate|t=[=loleteefe[atsl ole 
rs [or [oe oe] ee [es] e+ [es [ew ler [ee] [a] co [a] or | 
petrol eff wf ve[mefar te fenton ton foe fon [of of 
rer [ae | ve] m2 [as | me [as | ow [ar [ae [ae [eo | a | oo | as | 7 
ra [ee | oe sr] a2 | as] a : 
ro[rr fac] sel es | co] x | oof on [or [ec fre |e [er| ee] sF| o 
ra [as [ss | cc] oe | | oo [om | om [oe [sr | om [oe | or | a] on | oo 
UES a dd Ee EE EE EE 

“EEEESEEES 

e [ar | se | se] or | oe | or 
: 


Figure F-4. Belgian, Swiss-French, Swiss-German Conversion from ASCII to EBCDIC. All digits 
are hexadecimal. See the notes on page F-5. 


























First ASCII Digit 
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Belgian, Swiss-French, Swiss-German Two-Byte Values for ASCII 


to EBCDIC Translation. 


ASCII 


1FA0 
1F'B4 
1FB5 
1FCO 
1FC1 
1FC2 
1FC3 
1FC4 
1FC5 
1FC6 
1FC7 
1FC8 
1FC9 
1FCA 
1FCB 
1FCC 
1FCD 
1FCE 
1FCF 
1FDO0 
1FD1 


Figure F-5. 


EBCDIC 


B3 
B6 
B5 
46 
59 
62 
64 
65 
66 
70 
72 
73 
74 
75 
76 
77 
78 
80 
8C 
8D 
8E 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FE0 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


9D 
9F 
AC 
AD 


Belgian, Swiss-French, Swiss-German Two-Byte Values for ASCII to EBCDIC 


Translation 
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EBCDIC to ASCII Translation for Belgian, Swiss-French, 
Swiss-German 


a Second EBCDIC Digit ——————— 


oO 
ala 
a 





> 









> 


—_ Oo 
= ~S 
>i nin 


— 
—_— 
—S 
NO 








> 
> 


gs 
~S 


> 
> 


O;— —_ O 
a 
— O 
cae 
ale|s 


co Leta) 
c[eleefeta sal al = 
noongoooGne 

re [eo| sa [25] «| 27] so) 2 
: tet atelatetelelel ete : 
ra [ral ea] eal sc] oof ee| o[ | n| 2] | | or] | o| 
afee| ef val v[ v5] v6 | 77[ v= | v0 | | 0 | ma | oe | os] oe | ov 
efet el ol of ol elf ele loll ef elo el 
re] | «| a) 3] «) o) «| ole rm 
at etal atat at et elaletatetaldtat ote 
let etaretel al etetatetste sterer a 
ref sof | sel asf ef as [se] [se [eff mo] pre 


EN 
NO 
8 
s 
Olo;ojfrhe-m]— 
me |oO!]wWwi ot] > 


Oo Co Co 
O mM = 


ie) Ww | > wn 
O > > —t O © 


jo | 
© 
ie) 
Oo) 2) 
NO ~S 


C8 
63 


First EBCDIC Digit 





Figure F-6. Belgian, Swiss-French, Swiss-German Conversion from EBCDIC to ASCII. All digits 


are hexadecimal. See the notes on page F-5. 
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Canadian-French 


ASCII to EBCDIC Translation for Canadian-French 


Second ASCII Digit i none, 


raps pepspe[[epsp spay ep a] aye 
200 Oooo 

se[ fe [as [ie] vo | oF 

: Bago ; 









First ASCII Digit 


On 


WiiWw i Ww] Ww O Co O;rninontnm |] Oo 


a | 3 | oF 

af | oF | F 
3F sr 
rae [ar fae [oe far [oof ae] ar fe] arf eal arf re 


Figure F-7. Canadian-French Conversion from ASCII to EBCDIC. All digits are hexadecimal. See 
the notes on page F-5. 
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Canadian-French Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII EBCDIC ASCII EBCDIC 
1FA0 B3 1FD2 9D 
1FB4 B6 1FD3 OF 
1FB5 B5 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 BC 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC 77 1FE1 EE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1F D0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure F-8. Canadian-French Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for Canadian-French 


Se Second EBCDIC Digit 


Nd Td 
fe foo for caf on [tay on fom [mr [a | va] om | oe | ce | oo 
Nd A 
epapstat eat sf epe bale abel eff [a 
re pae aa eve va ve ve | we te | ve Pe 

epepaps| eps el epee tele alee ae 
BIL CI IIE ILI LILI RIEJEIES 
efofefelefe[ [spore fm] apa] a] efx] 
Tle[e|ofefelalelelole|«[a| «| a x 
Bi os 
Bd 
apm [ [77 [me [me [m| [oe] | oS of or 
efeefo[ ol] ef e[ =m [x fe[ [alo] [of mlm 
epepap epee] s[elo pela] mes) of op a] 
offal] [ole er [so[s[se[ =| of ar| or] sl 
re foe [a] ss] [9] [off fm) of] opal 
Fle[s| 2) s[[s[s[9[s[s] Se, a, spa] a 


Figure F-9. Canadian-French Conversion from EBCDIC to ASCII. All digits are hexadecimal. See 
the notes on page F-5. 




















pp] Ww 


io) 





First EBCDIC Digit 
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Danish and Norwegian 


ASCII to EBCDIC Translation for Danish and Norwegian 


a Second ASCII Digit —————————e 


| fof sf af sf +] 5] 6{ 7/ ao} of a] 8] cf of ef F 
0} oo} or o2| os| s7| 20] 2] aF| 16 | o5| on] o8| oc | oo] oe] oF 
pi | to] s{ rz] ts] sc] so} 32] 26] ta | to] ar] a7] | + | + | 
/2| 40] ar] v{ sal o7| oc | so] | 40 | so] » apa ecmhieees 
rs | re r7| ra| rol mal se pc] oF 
4 | 80 | cr} c2| cs] ce] os | o6 | c7 | ca | oo 
| 5 | o7| oa] oo] e2| e3| e4| e5| €6| e7 | ca 
[6 | 79| e1| e2| s| o4| a5 | o6| 67 | 06 | a9 
| 7| 97] se{ oo| a2] as| ae] as | a6 | a7 | ae] ao| oc | ae | 47| oc| o7 
pe{ica| ai| si] 42] 45] «| o0| sa] s2| 55] 54] 57| 56| s0| 63] se 
pa | 7 col 7] ca| col oo 2} Bom a4 
pal as| ss] ce] ve| «a| 69] oa| 98 | a] sr | ea] a6 | 07 
reff st sl sf etl els [sf] x [ol a ol 
Ea of | or | or 
Haan as annascone 
sf 
pe] se| ar] sr] se] ae] sr] sr] | oo] ae] sr] sr} se | eal ae] rr 


Figure F-10. Danish and Norwegian Conversion from ASCII to EBCDIC. All digits are hexadecimal. 
See the notes on page F-5. 


















™ 
NO 

Se) o>) 
pp} 
™ “TT | GH 
om} 
my | > 17 
iw TN 
mit i 
“SJ | © | @ 

"Si 


WG 


ics) 
Oo mi orn o>) 
B Wie | - ~N 





ice) Mm OO —S 

wo OO 
alelele 
a 

WG 

© 

7 
a0 

on 


First ASCII Digit 
Oo 
Oo 
Oo 
NS 
oD 
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Danish and Norwegian Two-Byte Values for ASCII to EBCDIC 


Translation 
ASCII EBCDIC 
1FAO B3 
1FB4 B6 
1FB5 B5 
1FCO 46 
1FC1 59 
1FC2 62 
1FC3 64 
1FC4 65 
1FC5 66 
1FC6 6A 
1FC7 72 
1FC8 73 
1FC9 74 
1FCA 75 
1FCB 76 
1FCC 77 
1FCD 78 
1FCE 70 
1FCF 8C 
1FDO 8D 
1FD1 8E 


Figure F-11. 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FEO 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


9D 

5A 

AC 
AD 
AK 
AF 
B9 

BC 
BD 
BE 
BF 
CF 
DA 
EB 
ED 
EE 
EF 
FA 
FB 
FD 
FE 


Danish and Norwegian Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 1.1 F-17 





EBCDIC to ASCII Translation for Danish and Norwegian 


mane eee Second EBCDIC Digit a 


Od 
re [oo [orf en] os | vm] | om |r] | | om | co | oo | oo) oe | or 
re papapisfa Po foo fm fe fe [al ml mf al mp 
SHOR OR OOO OOOO 
Pia [ae ve pve paw ve [ow Paw | ta | 
eislatal atalmtametetate [atari ate! 
sas [m2] a] oo [ala |e [ele fo|o|er| 
siatelal lalate taietatatalelet sta 
7 [m[ololalcolale lalate] alsa = 
fe [oo [or] oo] es[e[e[os[er[e|o|m [efor] oof ofr 
fo [re [o| cel oo feof ee fer[m[n|m [a] a =| ocf se] = 
| % | [7 [7 | 7m [m= [mm [mf or | os] oe | ov 
{atatatstatststetetstatetetetate 
Be GORgOG 
raf ae] [ole a | oo fe [se] oe | oe] | ov) as] os 
eetatstetsl ato lwlefeteleelatete 


Figure F-12. Danish and Norwegian Conversion from EBCDIC to ASCII. All digits are hexadecimal. 
See the notes on page F-5. 















First EBCDIC Digit 
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English (UK) 
ASCII to EBCDIC Translation for English (UK) 


Pree ee Second ASCII Digit a gay 


Cees Pste peep el epee 
ff fal melon Poel ef [fw Lew 

ro[n[ wl s[s[s%|2felwlelsfal-[-[ | = 
pts fete SE RBOooAoog, 
alata bafateie atefela}eietejetate: 
rs [or [oe = [er [ee [eco | er | co| aa] a] w 
ciate late tet atetatatelctatatetate 
rz [or [mol | oe [as me [ase [oe [oa [ow Teo] or [oo] me or, 

[a [oe[ st eta] « [o : 
ptrtefatatetoteteletefeteletel s[s 
ala lete| clei [ole le la 
ete fofol = [el ete te fe lolol lolol ole 
ri sr | ar | ar | ar | F | ar | 3 
ola [orl o| wll lee le bw le fe |e | | 
efelefetefote tele fe tele felel ele 
re Lae Ler] se] sr [ar] or [or [ar [oo [oe | or [or [or [ex] oe 


Figure F-13. English (UK) Conversion from ASCII to EBCDIC. All digits are hexadecimal. See the 
notes on page F-5. 















2 


©?) 





First ASCII Digit 


Translation for AIX Version 1.1 F-19 


English (UK) Two-Byte Values for ASCII to EBCDIC Translation 


ASCII EBCDIC ASCII EBCDIC 
1FAO0 B3 1FD2 9D 
1FB4 B6 1FD3 9F 
1FB5 B5 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 Al 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC 77 1FE1 EE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FD0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure F-14. English (UK) Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for English (UK) 


Second EBCDIC Digit 





Ww) < o<@ <l cS — st < Ww Li oO wo Te) LJ © Ww 
oO ce oe <x <@ cs €5 oO wo ™ faa) a s+ Ww) N) 

s <x << < << Ww <x Mw) op) st Ww Le + Ww + 
N) My) no] < < wt Lil 9 @) >) © st oO | 2 a N) 
Oo — oe = CO co AB ice) ice) ~~ << t+ Ww Ns) 

N N N < ice) ae] [9 @) N ‘a N Ny) N mM N) N 
c ai = = oO CO © © © ™ st + uw) N) 

ef | |] Cl ec] ec] ae] le —-| < Ole] <] <i = 
Oo = = me ie @) N © wo wD ws i —_ NM) 

©) << <x © '<e) Q ice) LJ ie @) oO mM fc © 2 

=- —_ = N WN —N Cc) © Le LJ ™ ™ Ww) N) 

161g 910089 4S4l4 














All digits are hexadecimal. See the 


English (UK) Conversion from EBCDIC to ASCII. 


notes on page F-5. 


Figure F-15. 


Translation for AIX Version 1.1 F-21 





English (US) (ASCII) 


ASCII to EBCDIC Translation for English (US) (ASCII) 


If you requested the ASCII option with the emsend command, the host uses this table to 
translate from ASCII values to EBCDIC values. This table corresponds to information in 
the host’s IND$FILE program. 


iodine te second ASCII Digit i 


epayay sts, a] epel pape 
Seelet ale siete lelelat= 
cpio far] wa] as [se] 30 Pe | a6 [10 oe [ae [ar | 
ra [ao [sa] 7] v0 | 50 co [50 | 0 
ca iG 
cer a 
09 | Ez oF 
ree | es [ee [er a 
Peper [eel wef ae pas] a [as [as 










msm 


i) 
~ 
© 
® 


o2) 
m 

mio flo o|la|—-|o 

-/|o]wn nml—=}ni{ nino 


or 
~S 


Mm 
o>) 
On 
7 


'@) 

a 
a 
on 
mm; > | Wy 
mn} om | 
oO 
™S 


© 
~S 
oO 
On 


First ASCII Digit 
> 


ras [ae | is | [ 
ras [ae] as | | on 


se | 2 | 60 


oO NO oO) ce) Mm © oo 

f F > ie) oO WN O 

sali oO f © ~ = 
© 
on 


WIiNITO!;] oO ;TfL!] O]Tuo] +& 
Wil wiorini iri nimyim 


Oo 


~N 
m1 oO Oo Pi Nin; DOD ];| @oOyrms!, oyny| > 
m)} > m oO} om; ay nt woyrns] ©; WO] O 


mm} OO |W | Oo Mm |Win | > mi gina @ 
a1] ao j— | mn — | O | © | @ oO;wo;o;|] Oo 
NMiWwWini r | orm) VUInNnNI ow 
moO }_ Pir | orem | oy]nmasy_rsto 


se [55 | se [ 
rox [oe [oc | 9 | oe 
ss [or [es | 6 | or 

ce [co [oe [or | on | om 

rr foe fmf cel or Lex} eo feo len fer fer fm 


Figure F-16. English (US) (ASCII) Conversion from ASCII to EBCDIC. All digits are hexadecimal. 
See the notes on page F-5. 











NO 
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EBCDIC to ASCII Translation for English (US) (ASCII) 


If you requested the ASCII option with the emrev command, the host uses this table to 
translate from EBCDIC values to ASCII values. This table corresponds to information in 


the host’s IND$FILE program. 


SS Second EBCDIC Digit a 


Topsy [sy [els] ep op ep 
re [oo | orf e2| os | ac] o | ee |v [e7 |e |e | o| oo [oo] | or 
Pe fro[ [| fo] [cele [|i] olor [ilo] el 
ate eee eee epaieterei=t l=) 
rs [oo [or [ v6] 2 [oe] 35. roe [om [se | | os 

rae [ar [ao far far fae | a 
re [a0] ar[ e2| es| oe] e5 | e6| o [ee [oe | | a | a5 | or| x] or 
a ree [or [cof er fea [oo] | as| | 27] | 2 
ra [es] or sa] os | oe] eo | ce |e [ee [eo [os | os o7| | a 
re [ex a 











First EBCDIC Digit 


n |v [ow [oc fe | | oF | oo 
76 [ 77 [7 [70 | m2 | 05 | v4 | 05] 08 | 7 
oped ede eee EO stetefetelste 
se | ar | 0 [51 [2 

ie 55 ‘al@ieielatelalninl ele 





Figure F-17. English (US) (ASCII) Conversion from EBCDIC to ASCII. All digits are hexadecimal. 


See the notes on page F-5. 


Translation far ATX Versian 1 1 


F.22 





English (US) (TEXT) 


ASCII to EBCDIC Translation for English (US) (TEXT) 


If you requested the TEXT option with the emsend command, the RT PC 3278/79 


Emulation file transfer program uses this table to translate from ASCII values to EBCDIC 
values. 


a ele Second ASCII Digit ini enna: 


Tels] sp. ss] [eels] ele] ol pr 
nOOC OGD oOo OO000G 
se| [xe [as [ie [wo [ar[a[- >|. 
ptefstrts[=[ete[ste|=[=[el=[el =e 
A 
steteretetetstelela tel [telat fm 
rs [or [oe [ool] es] | es 
etme els fote fete late tefele [ale le 
Pr [ar[ os] e6) [as | m [as [aw [ar [oe [as | oo | ae [00] arf o7 
re [ ro] 70] eo] a] rs] s7| eo | oe [me | [58 | 77] 0 | 20] ov 
rs [ee] ra] oc] >| | o[ec[es[ec[m|m [a] a] | «| ar 
rao [ on] se] a | oo] | a | ar[ar [ar [se [ar] ar [ar] a |r 
GHne DEO RoOBoeRRne 
tletelet stele leteteieteieitierete 


Figure F-18. English (US) (TEXT) Conversion from ASCII to EBCDIC. All digits are hexadecimal. 
See the notes on page F-5. 





















First ASCII Digit 





TD OA 29°70 /'770 Demaualatian 


English (US) (TEXT) Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII EBCDIC 
1FAF 46 
1FB5 48 
1FDB 55 


Figure F-19. English (US) (TEXT) Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 1.1 F-25 





EBCDIC to ASCII Translation for English (US) (TEXT) 


If you requested the TEXT option with the emrev command, the RT PC 3278/79 
Emulation file transfer program uses this table to translate from EBCDIC values to ASCII 
values. 


ene Second EBCDIC Digit 


eT 
re [oo [or [we | 
ECuORE 
2 fia fe 


———_—_—___—_—_—, 


Tetetatepefet ete 
in [i [om [os [oe | oe | or 
: 
Sate late eiere, 
ofr fe fa fa [i fw foe 
Sete 
an [oo [a [me |e [| oe 

: 

P| 2 
















BE 


= 


oO. mem] OO et i oI ona it @ i @ 
oO NIT MPL ar oin  oia ; am 
Oo 
> 


On 
Bi 
On On 
Ba 
eee 


> 


> 


wo NO _ > a 


First EBCDIC Digit 


BR ~S SN 







‘ ree fn pe 
SENCICARIECS 
rer fm [ar [ao | | 


Figure F-20. English (US) (TEXT) Conversion from EBCDIC to ASCII. All digits are hexadecimal. 
See the notes on page F-5. 


= i oe = ~ oO) oO 
ON On co a aa ~S e2) o>) Co co = oO = —_ —_ 
WG ff O N aa > '@) WG — ~S > © > > WN on ies) 


ies ul > oo on ™S ie) Oo o>) NO a 
CN un Sf a On ™S Oo) ie) Oo e)) wo —_ O O 
o2) o>) mM 2) wo Dn ™m On f ae mM > > > On 


Gitnh | &® |e] & | anlolwol!]r!] mi —| = 
N}1WIil Din] ol]w yilruilal>loloal>|n 
wWwilin;lrAR AL oO!]lN{o oO; >]|-|-— < 
ois im | ol] wisi] sim" |] >] 


Wi nw ni insnsy FF | FE] WD] DW NO | NMI] NO] = 
oe;OoO; ol wows; al or nit = Oi al aol > 


is 
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Finnish and Swedish 


ASCII to EBCDIC Translation for Finnish and Swedish 


A nT TT aati ASCII ee 
Tey sy sf ef fe [al el eof ep 
Foo| ox] e2| ao] s7| ao] ae] ar] ve | os | on | o@ | oc | o| oe | oF 
[ve efor fa]. |. | | 
no oS ecco 
rol ri] val ra| ral rs] re 
etetel ef etal etal ols [e[orfole le LaLa 
pefapab abel eel wll woffa lel ew 
Pr [ er] onl ool x2 | a3] ae | as | ae re 
Eran ere eect tete tee ot a 
Feo] wc] ee] ca] sal col ow] oo| or | 70] re | oo] a: | se] sr] 
Palas] s5[ ce] oe| <0] co| on] o/s [ar [ee [oe] or] ml | os 
NEE ie Bo eee 
ref ae} ar] ar] se] se| ae] ae] orl ae [ar] o 
Pol sel ar| orl srl sel ae] ae] ar[ar [ar [ar | ar [or |r| sr or 
ref sel or] orl sr| sel se] se] srfoo [ar] sr] ar [ar] eal | rr 


Figure F-21. Finnish and Swedish Conversion from ASCII to EBCDIC. All digits are hexadecimal. 
See the notes on page F-5. 









Oo 
— | © 


Bs 
oO 
a 












First ASCII Digit 





Translation for AIX Version 1.1 F-27 


Finnish and Swedish Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII EBCDIC ASCII EBCDIC 
1FAO B3 1FD2 9D 
1F'B4 B6 1FD3 5A 
1FB5 4A 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 BC 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC 77 1FE1 EE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FDO0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure F-22. Finnish and Swedish Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for Finnish and Swedish 


Second EBCDIC Digit 











O < <= © <e) QO ce) Lid cO <e) t+ © 
r = — N NN N O ©O Lie Li co ne) 


1161q JIGDg3 4S4!4 


All digits are hexadecimal. 


Finnish and Swedish Conversion from EBCDIC to ASCII. 


See the notes on page F-5. 


Figure F-23. 


Translation for AIX Version 1.1 F-29 


French (AZERTY) 


ASCII to EBCDIC Translation for French (AZERTY) 


Second ASCII Digit 


See eee $161q |IOSV panos inal 





Figure F-24. French (AZERTY) Conversion from ASCII to EBCDIC. All digits are hexadecimal. See 
the notes on page F-5. 
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French (AZERTY) Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII 


1FA0 
1FB4 
1FB5 
1FCO 
1FC1 
1FC2 
1FC3 
1FC4 
1FC5 
1FC6 
1FC7 
1FC8 
1FC9 
1FCA 
1FCB 
1FCC 
1FCD 
1FCE 
1FCF 
1FD0O 
1FD1 


Figure F-25. 


EBCDIC 


B3 
B6 
5A 
46 
59 
62 
64 
65 
66 
70 
72 
73 
74 
75 
76 
77 
78 
80 
8C 
8D 
8K 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FEO 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


French (AZERTY) Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 1.1 F-31 





EBCDIC to ASCII Translation for French (AZERTY) 


Chih ack ae ie Second EBCDIC Digit aT 


Tey eps] [=]. *[ 7, *]*]*]*] [eo] ep 

ron oef es [val om [or [om fe [om [| [oo [ok 

rial 13 | om | ow 

fine fw Pe rin fa 05] 08 | 07 

r+ [ao [rapes] e | 40| feo [eo [sc[m| rel 2 | | 20] a) 2 

[=f fe Boome 

eteteleletelete[s alstel sls 

tial alo ala pialalelel a oon 

efatotetetatetacelelsleteie 

etererate 

InAs 

Pre 

res 

ros 





Mm 
“ey 





i?) 
mM 
nN 


> 
> 
> 
> 


> 
> 
On 
© 
~ 


On 
> 
> 


canals mali wally Oo 







First EBCDIC Digit 


~— 

Oo 
~S 
© 
~~ 


<@) 
ae 
UO fb cos UO ~S Oo) 
® 
+ 
> 
'@) 
> 


slslul sl etal wiwla le le 
re} oe 2s | sof v0 | or] so for] ac || oe | a 
4s | 47 | 48 | 49 | 
etm[al ol wel eleleta le 
reler| val ss] o | ss] ss [sr] seo ]s |e] o| [ol ale 
resol sr [se] 3] x] 3 [se [sr |e [se 


Figure F-26. French (AZERTY) Conversion from EBCDIC to ASCII. All digits are hexadecimal. See 
the notes on page F-5. 


~S 
Oo 
~~ 


re [ss [en] co] oo eo] cor | mn [me 
roe | 7 | os | oc 


morc 
Per [ial as] se 


OO 
f 
mo 
On 
Oo 
on 


on 
~S 
On 
Oo 
on 
> 


nh 

fe) 

tS 

~ 

a 

Co 

» 
MIO IF IF IS ISS 
Re > ee 
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Italian 


ASCII to EBCDIC Translation for Italian 


Second ASCII Digit 










re [or ow Pf ee es [oo | ae si] sr] 
SOMO G Oo GOO oe 
nie latedeteieteeeieiatate eter ete 
ra [7 [se | ve[ ee [oo] e [oe |m [or [ee] ro] eo] m| a] | a 
ra [as [55 | ce] oe [oo] ee [on [oe [me] or | a] oe | a7 | an] on] oo 
ENEg Eg gd ge 
Ea 
ro [ae [ar | | 
Tar fara ar far 
= [oe [or [ae [oe [| a 


Figure F-27. Italian Conversion from ASCII to EBCDIC. All digits are hexadecimal. See the notes on 
page F-5. 


First ASCII Digit 





7 






eo 
WW 
7 5 oa 


Translation for ATX Versinn 11 4xF-328 


Italian Two-Byte Values for ASCII to EBCDIC Translation 


ASCII EBCDIC ASCII EBCDIC 
1FA0 B3 1FD2 9D 
1FB4 B6 1FD3 OF 
1F'B5 7C 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 BC 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FE0O ED 
1FCC 77 1FE1 KE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FDO 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure F-28. Italian Two-Byte Values for ASCII to EBCDIC Translation 


F284 3978/79 KRmulatian 


EBCDIC to ASCII Translation for Italian 


Second EBCDIC Digit 





$161q O10dD89 4S4!4 


Italian Conversion from EBCDIC to ASCII. All digits are hexadecimal. See the notes on 


page F-5. 


Figure F-29. 


Translation for AIX Version 1.1 F-35 


Japanese English 


SIZ 1G EEE 


Second ASCII Digit 


im | © O 
N 1M | © 


SOOGoEGagooRoCd au | 
[Bee che sla agg OSV pelah ja stl 


ASCII to EBCDIC Translation for Japanese English 


Figure F-30. Japanese English Conversion from ASCII to EBCDIC. All digits are hexadecimal. See 


the notes on page F-5. 
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Japanese English Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII 


1FA0 
1FB4 
1FB5 
1FCO 
1FC1 
1FC2 
1FC3 
1FC4 
1FC5 
1FC6 
1FC7 
1FC8 
1FC9 
1FCA 
1FCB 
1FCC 
1FCD 
1FCE 
1FCF 
1FDO 
1FD1 


Figure F-31. 


EBCDIC 


B3 
B6 
Bd 
46 
59 
62 
64 
65 
66 
70 
72 
73 
74 
75 
76 
77 
78 
80 
8C 
8D 
8K 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FEO 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


9D 

OF 

AC 
AD 
AE 
AF 
B9 

Al 

BD 
BE 
BF 
CF 
DA 
EB 
ED 
KE 
EF 
FA 
FB 
FD 
FE 


Japanese English Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 1.1 F-37 





EBCDIC to ASCII Translation for Japanese English 


= eeneeen Second EBCDIC Digit ain 7 adie ain 


ss 

ra [oo [or | oa] os || o [om fm [om] im] | o@| 0 | ow] oc| oF 

fre fs [ra fas [mon [oe [tm fe [ve fim] mpm] wa va] ve 

BOO OOOO Seo oonG 

: atu fale fatetatefetat a! 
|so [8a | at | sc | 88 | 80 | Cr 


fe fatetetefefefatetatete 










NO 
oO 
Co 
& 
Oo 
Bi 


1o)) ~S e) 
eo) ) 
elias 
om 19 
ie) 
a 
Ei 
~S 
a 
mM 
a 
=. 
2) 
a3 
O 
nn 


First EBCDIC Digit 


~ mM 1 NO 
uO oO Oo NO 
ie) > —_ nN 


els | [a [ules[o]os| aa] oo 
rae [or [50 [si [so] ve | oe [or | o7| 03 | so 
re [ar [im] ss | s+ [55 | se [57 [50 [50 [on] ro] or| oo | col er] 


Figure F-32. Japanese English Conversion from EBCDIC to ASCII. All digits are hexadecimal. See 
the notes on page F-5. 
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Portuguese 


ASCII to EBCDIC Translation for Portuguese 


cer aikeee Second ASCII Digit bpairerarere 


ate fepete eat fereratabatelatata 
pa [so fat ve) ae |e | ao | | to eee 
CEO Ss se we eee 


Htefetst=tels|=[[e[s[@[=[stelelS 
ror [| oe 

Stetetete fale fs fe fet m[s fet sf aff 
rar [oe [ae] m2 [as oe [as [as 
re feo focfs| alow lolm|s| ss] | o7| | so! o 
ref feel wef eo feel eo foe foo [orf [re [w|i | ml sw 
ce[ oe [wo [oe [on [oo [aw | or | on | oe] or] | om 
BiG eG iGgG Oe 
; rae [ar [ae [ar [oe [ae [ar] oe or 
ieee ete eo tetelelaleletet are 
re [ae fer [orl [orf ar [oe [ar [oo] ar] se | orf or] eal 


Figure F-33. Portuguese Conversion from ASCII to EBCDIC. All digits are hexadecimal. See the 
notes on page F-5. 




















First ASCII Digit 





=F 
WG 





Translation for AIX Version 1.1 F-39 





Portuguese Two-Byte Values for ASCII to EBCDIC Translation 


ASCII EBCDIC ASCII EBCDIC 
1FAO B3 1FD2 9D 
1FB4 B6 1FD3 OF 
1FB5 B5 1FD4 AC 
1FCO CO 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 BC 
1FC5 7B 1FDA BD 
1FC6 70 1FDB DO 
1FC7 72 1FDC BF 
1FC8 73 1FDD 6A 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC 77 1FE1 EE 
1FCD 78 1FE2 7C 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FD0 8D 1FE5 FD 
1FD1 8K 1FE6 FE 


Figure F-34. Portuguese Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for Portuguese 


Second EBCDIC Digit 





| | of s{ 2] 3] 4] 5s] s{ 7] e| 9{ al a] cl} of ef & 
7 | 1a | | on | 08 | oc | oo 
SR Sooo oSSoeee 


ror] a] os [i] oe | ow 


as 910943 Se | 








All digits are hexadecimal. See the 


Portuguese Conversion from EBCDIC to ASCII. 
notes on page F 


Figure F-35. 


-5. 


Translation for AIX Version 1.1 F-41 





Spanish 
ASCII to EBCDIC Translation for Spanish 


Second ASCII Digit 


Se orerery 


















stotatetstal wielal eles [alate 
rr fe[ Pal spe] so fsa fase [ie fsfary > [=f f= 
DOOR OnnoOogon 


F7 | Fe | Fo | 70 
ctetelete[e sees lel ee] oe 
| 5 | 07 | ba] oa] e2 | Es EO 
etapa ey sfot stator fet a af fla 
|7 | 97 | 98] 99] 42 | as] as | as | ae | a7 | as | a9 | co| 4F | 00] 80] 07 
e[efees|elsl«|ofels|s[ os] [| | o 
etatstefeteteteteletetetetn tel el a 
fap mets feel erp al en 
eletels| <[ol ste) aistelsiel ets) ele) 

oF SF | oF oF 
etetulsteteleleteteratets) 
Pepe far[ sep a Pea [oo [xe [oe fa Poe | arf | oe oe oe 
Pebse forbs psele [rsa feeb artless 


Figure F-36. Spanish Conversion from ASCII to EBCDIC. All digits are hexadecimal. See the notes 
on page F-5. 








First ASCII Digit 
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Spanish Two-Byte Values for ASCII to EBCDIC Translation 


ASCII 


1FA0 
1FB4 
1FB5 
1FCO 
1FC1 
1FC2 
1FC3 
1FC4 
1FC5 
1FC6 
1FC7 
1FC8 
1FC9 
1FCA 
1FCB 
1FCC 
1FCD 
1FCE 
1FCF 
1FD0 
1FD1 


Figure F-37. 


EBCDIC 


B3 
B6 
B5 
46 
59 
62 
64 
65 
66 
70 
72 
73 
74 
75 
76 
77 
78 
80 
8C 
8D 
8E 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FEO 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


9D 

OF 

AC 
AD 
AE 
AF 
B9 

BC 
Al 

BE 
BF 
CF 
DA 
EB 
ED 
EE 
EF 
FA 
FB 
FD 
FE 


Spanish Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 1.1 F-43 





EBCDIC to ASCII Translation for Spanish 


ae aaa eS Second EBCDIC Digit SS a 













Nr ocie 

al at uleimieiaisiealsl siete ete 
AMO NCSC 
psi} ie} wa] tal ta] 1a | 04 | 
[afl a[ oe [| [cl [ofl] ls [a[ ae 
(5 | 26 | 82. 29 
PEGE See eee 
/7 | c6| 90{ c7| cal cal cal oa) cc} co| 60 | 3a | as | 40 | 
sl elelulbinisteleteletalel of of ws 
aim tat ol alel a ttwle inl alete teal 
aime al alanine leinlatel al of 
efoto el alae ol oof [oe nfs far off of 
re | 7a | a1 | a2] 43 | 
alslnd al aietale aint tele! 
tim tnl al siete lieialeininl ete 
ry 


Figure F-38. Spanish Conversion from EBCDIC to ASCII. All digits are hexadecimal. See the notes 
on page F-5. 


ef 


First EBCDIC Digit 
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Appendix G. Translation During File Transfer for 
AIX Version 2.1 


Translation for AIX Version 2.1 G-1 


CONTENTS 


ie oe Wee re a ee rr er ere ee G-4 
Aboot Transisiion Davin Vile Tastee 1a us cc eid Ke ea cee Ree wR ERED G-5 
Langiave-to-Cade-Page Nimbér Chart «ic cicivi wea ieee Re E KEBLE HEHEHE G-6 
PSPS TOVIOAT nn Ri ew eE RARER EERE RIMS RAKED MRE KA BEER RKTT TET ERS G-7 
ASCII to EBCDIC Translation for Austrian/German .................000005 G-7 
Austrian/German Two-Byte Values for ASCII to EBCDIC Translation ......... G-8 
EBCDIC to ASCII Translation for Austrian/German .................020004 G-9 
Belgian, Swiss-French, Swiss-German ........... 0... cece cece eens G-10 
ASCII to EBCDIC Translation for Belgian, Swiss-French, Swiss-German ...... G-10 
Belgian, Swiss-French, Swiss-German Two-Byte Values for ASCII to EBCDIC 
(ec a a ee ee re G-11 
EBCDIC to ASCII Translation for Belgian, Swiss-French, Swiss-German ...... G-12 
ART PYOUCN occ c ue hk KE Rs HER RARE EOH RR EO BLL RE eww LEP ee G-13 
ASCII to EBCDIC Translation for Canadian-French ...............0000000% G-13 
Canadian-French Two-Byte Values for ASCII to EBCDIC Translation ........ G-14 
EBCDIC to ASCII Translation for Canadian-French ..................005. G-15 
Danish and Norwegian! .... 0.6. cca ree enim ners wee re we neeswee ne cew ee ees G-16 
ASCII to EBCDIC Translation for Danish and Norwegian .................. G-16 
Danish and Norwegian Two-Byte Values for ASCII to EBCDIC Translation .... G-17 
EBCDIC to ASCII Translation for Danish and Norwegian .................. G-18 
StU Be wo ie whe Se in oe 4d ee Ee ee ee ee we ie ee Pk os on eo G-19 
ASCII to EBCDIC Translation for English (UK) ......................04. G-19 
English (UK) Two-Byte Values for ASCII to EBCDIC Translation ........... G-20 
EBCDIC to ASCII Translation for English (UK) .......................0.4. G-21 
English (US) (ASCID): 2. 0. ce we ee we wee ee ee ee eee G-22 
ASCII to EBCDIC Translation for English (US) (ASCID ................... G-22 
EBCDIC to ASCII Translation for English (US) (ASCII) ................... G-23 
PUT Le) viecuue 2 i hee eee ee ee oe ea ieee nena cs oan a0 ss G-24 
ASCIT to EBCDIC Translation for English (US) (TEXT) «isiaseccustsavanwca G-24 
English (US) (TEXT) Two-Byte Values for ASCII to EBCDIC Translation ..... G-25 
EBCDIC to ASCII Translation for English (US) (TEXT) ................... G-26 
Finnish and Swedish ......... 0... cece eee eee eee ee eee eee eee eae G-27 
ASCII to EBCDIC Translation for Finnish and Swedish ................... G-27 
Finnish and Swedish Two-Byte Values for ASCII to EBCDIC Translation ...... G-28 
EBCDIC to ASCII Translation for Finnish and Swedish ................... G-29 
Pee (et Ee pase ke Peed see we bare we i ee 0 89 Se cS Sat wh ee G-30 
ASCII to EBCDIC Translation for French (AZERTY) ..................... G-30 
French (AZERTY) Two-Byte Values for ASCII to EBCDIC Translation ........ G-31 
EBCDIC to ASCII Translation for French (AZERTY) ..................... G-32 
i a ns oe hee a an ee an ee an G-33 
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ASCII to EBCDIC Translation for Italian ................ ccc cece cucccas G-33 


Italian Two-Byte Values for ASCII to EBCDIC Translation ................ G-34 
EBCDIC to ASCII Translation for Italian ............ 0... cee eee eee eee G-35 
pepenede BUCS «bare kd 446 ok ee we ne Hee we wet es WE keen Bees G-36 
ASCII to EBCDIC Translation for Japanese English ...................00. G-36 
Japanese English Two-Byte Values for ASCII to EBCDIC Translation ........ G-37 
EBCDIC to ASCII Translation for Japanese English ..................005. G-38 
PORN. a ee eae he oa eS 6a hee VS BE wd RA eh oe ee Ree oO ae Be wee eR G-39 
ASCII to EBCDIC Translation for Portuguese ............... 00000 e ee eeee G-39 
Portuguese Two-Byte Values for ASCII to EBCDIC Translation ............. G-40 
EBCDIC to ASCII Translation for Portuguese ............... 000 e ee eeeee G-41 
GMD, oe ee hae KO oe Oe 6S & 6d Dl los ON ee ae ae be pee bere EM G-42 
ASCII to EBCDIC Translation for Spanish ........... 0... 0000 eee eee eee G-42 
Spanish Two-Byte Values for ASCII to EBCDIC Translation ................ G-43 
EBCDIC to ASCII Translation for Spanish .......... 0.0... 000 eee ees G-44 


Translation for AIX Version 2.1 G-3 


About This Appendix 


This appendix is used with Version 2.1 of the AIX Operating 
System only. Version 1.1 of the AIX Operating System uses 
different translation code pages than the Version 2.1. Be sure to 
use Appendix F or Appendix G according to the version you have. 


The pages in this appendix show the translations between ASCII 
and EBCDIC during file transfer for each supported language. 
These tables are specific to the file transfer function of 3278/79 
Emulation. 


The tables in this appendix are listed by language. The 
“Language-to-Code-Page Number Chart” on page G-6 shows the 
Country Extended Code Page (CECP) or the Code Page (CP) for 
each language. 


G4 2978/70 BRmulatian 


About Translation During File Transfer 


Files stored on an RT PC are in ASCII form, while files stored on 
the host are in EBCDIC. Therefore, we recommend using TEXT (or 
ASCII) mode during file transfer. 


If you send an unsupported ASCII character such as a form feed to 
the host, a substitute character will replace the form feed in your 
file. When you copy the file back from EBCDIC to ASCII, the 
ASCII equivalent of the substitute character will appear, not the 
form feed you originally typed. 


Otherwise, when a supported character is translated from EBCDIC 
to ASCII (during emrev) and then back to EBCDIC (during 
emsend), there is no overall change. 


In the charts and tables of this appendix the following notations 
are used: 


e A substitute value of 1A for EBCDIC and 3F for ASCII is used 
when the character being sent is not supported. Some 
applications may display a substitute character, but other 
applications may not display anything. 


e On each of the ASCII to EBCDIC tables, the * in 1C, 1D, and 1E 
positions represents a two-byte character. However, the 
substitute value is always used, because none of these 
characters are supported. 


e Also on the ASCII to EBCDIC tables, a * in the 1F position 
represents a two-byte number. Possible values for that number 
are listed in the chart following the ASCII table for each 
country. For any 1F values not listed in the chart, the 
substitute character is used. 


Translation for AIX Version 2.1 G-5 


Language-to-Code-Page Number Chart 






















Language CP Starting on Page 
a 

(ASCII) 

(TEXT) (modified) 
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Austrian/German 


ASCII to EBCDIC Translation for Austrian/German 


SS Second ASCII Digit arin 


a es 
fof eof af ef fol wll fe forte fol aoe 
sal ou sal a3] oe] ae] wl [ele leods Te] 1 
el ateer a erat eratetatetetetetate: 
sim[ nl | se] wl el ele l eae le) ol 
raf ws| cx] ce] os/ c+) os] co] c7|es | coor | oa] 03 | ve) 06] os 
s|o7| 08 e5| e6|e7 | es | eo | 63 | ec | rc| sr] | 
rete eretetete tet at ee 
etsel alcatel 
slel wiht etal a alelelels|si=lal «ls 
etn Wat ol ell el le te lela fel wl 
i ulei sl aie te lete lal al ole 
BBE 
| | 3F aa 
ralanl get Sah ol oat el et eae lac 
efeefof al of el ef ol ele lef e[m[m[o| «fe 
ries wl sel ml ol ol el olole [ele] ell = 

















First ASCII Digit 





Figure G-1. Austrian/German Conversion from ASCII to EBCDIC. All digits are hexadecimal. See 


the notes on page G-5. 


Translation for AIX Version 2.1 


G-7 


Austrian/German Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII EBCDIC ASCII EBCDIC 
1FA0 B3 1FD2 9D 
1F'B4 B6 1FD3 OF 
1FB5 7C 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 Al 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 BC 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC iT 1FE1 EE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FD0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure G-2. Austrian/German Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for Austrian/German 


Second EBCDIC Digit 


tj ct} wWws} ot] Sy oy, Wy OF] AT] ot]}_ oo}; MO] Al] O 
Sleteia| Slat &l S| <1] 2] 2] S213) ele 
|) Oi) —) 1 Se] wey eB Mi <7] P32) Oo] NAN] =] oS 
ct; oOo; <} <]e Li —-)1 DO] OM} O;] ~| MO} WO 


mf i | <<} wm] mom} uw rw) Oo] Gi Bs] | Gt BS 
Ps 7 = i ee | SS co}; © oy mm | & | =F ST | WE mS 
< m1 a1 Oo Tat & I] & le | P| S|} OT kT Pe FT fe 
© we Gwe i) | we ge | Oo; | Be Sa Se a OD 


aa 
et 





PAE Ea allie 910993 se enamel 


All digits are hexadecimal. See 


Austrian/German Conversion from EBCDIC to ASCII. 


the notes on page G-5. 


Figure G-3. 


Translation for AIX Version 2.1 G-9 





Belgian, Swiss-French, Swiss-German 


This code page is used for Swiss-French and Swiss-German, and is the default for Belgian. 


ASCII to EBCDIC Translation for Belgian, Swiss-French, 
Swiss-German 


ae Second ASCII Digit ay 


fol si] 2] 3] 4] s{ 6] 7] 8] o| al 8] cl of ef F| 
Taos foe [ea an fae | om fae [ow [anf | oe oo] ce] ool cel 
rieiulelulsletali[wielelele ls [eto 
= [s|m[o| | | «| «| «| «| or 
[sre Perf ea| es [cx] os [os] er| | co] or o2| os] v4] os] oe 
(5 |o7 | os | oo| 2 | e3| e4 | es | es | ev | c8| e9| 4a| co| 5a, 
efmferfeel [of eae fm foefe| of owl ol 
(7 | 97 | 96 | 99| 22 | as 
AAA Scere 
fe) foe ol wf ae) oe) oo] | ak 
INO Sree 
Pl 2 
6A 















un 
7 


“68 


O07 


First ASCII Digit 


es 
sf | 46 | o6 | ar | ar | ae | or | or 
elm tos) a) wl ml te orl | a al al eal 
Spee ete alae al 
/e [ca | er | er| a | 86 | os | sr | 90 | o0| oo] o5| sr] ra] eal a 


Figure G-4. Belgian, Swiss-French, Swiss-German Conversion from ASCII to EBCDIC. All digits 
are hexadecimal. See the notes on page G-5. 


oF 
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Belgian, Swiss-French, Swiss-German Two-Byte Values for ASCII 


to EBCDIC Translation. 


ASCII 


1FA0 
1FB4 
1F'B5 
1FCO 
1FC1 
1FC2 
1FC3 
1FC4 
1FC5 
1FC6 
1FC7 
1FC8 
1FC9 
1FCA 
1FCB 
1FCC 
1FCD 
1FCE 
1FCF 
1FD0 
1FD1 


Figure G-5. 


EBCDIC 


B3 
B6 
B5 
46 
59 
62 
64 
65 
66 
70 
72 
73 
74 
75 
76 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FEO 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


9D 

9F 

AC 
AD 
AE 
AF 
B9 

BC 
BD 
BE 
BF 
CF 
DA 
EB 
ED 
EE 
EF 
FA 
FB 
FD 
FE 


Belgian, Swiss-French, Swiss-German Two-Byte Values for ASCII to EBCDIC 


Translation 


Translation for AIX Version 2.1 


G-11 


EBCDIC to ASCII Translation for Belgian, Swiss-French, 


Swiss-German 


Second EBCDIC Digit 





oO) —_— 
o<¢ 10 @) <x << ™ Li _ (o>) mM CO = (o>) ie @) 
—-}| =| =| =—| wo ra) Nw} Rm] ct] +r] mo] oT] 
ms bi. < mM bs Mm Li ™ ©) co €5 ™s Oo ie @) me 
melo i =| & co} © o;lerin| ct] +r]/ Oo] oOo] 
<x ™ - @ wo © ™ ™ Lu ie a WO Li ™ WO 
© = = © © | oO ™ LL st a Ww sy 
Ww <t < < Cc < Ww Ww LiJ ice) Ww) Ww Li WO Ww 
st < << o<@ <x wy < ™ t+ ba wo LL + OQ wea a 
—_ - - — cO oO mM QO © ™~ oO) vt + wo yy 
NM) N) 1 o) < < + Li MN) ‘) © st <r ne) © a ~) 
oO = - ee cO co 5 | oO ice) ™ Or + st Te) Ms) 
N N N <x ice) N) [2 @) N N My) Li N aa) My) N 
oO _ — —_— CO CO Q ‘oO ms mM bs a Ww N’) 
—fof or] ot] tl tpn] =| ££) @) OO] =) =] =<] = 
Ole el el -— 1 ol es ol O| R| aA] +] Fl -—1| mM 
© << << oO wo Q cO © mM Q © oO 

1161q DIdDGa 4S4l4 











All digits 


ASCII. 


-German Conversion from EBCDIC to 


Swiss 
are hexadecimal. See the notes on page G-5. 


-French, 


Swiss 


Figure G-6. Belgian, 
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Canadian-French 


ASCII to EBCDIC Translation for Canadian-French 


Second ASCII Digit 








™ bi ™ M™ oO ™ © CO s+ ice) Lil 
N N ™ LZ. ee Li CO < be WO ™ [9 @) 
Lu N oO i<e) ice) Ww) w ™ < N ice) Ww Oo Le 
N My) Ww oe © LiJ © a oO ice) sw MN <x NM) 
N N N Li N N N = Lid Li Le Li N mM Li 
oO - MN oe €5 co Ww [@>) © 1 o] N) ™ Lil mM 
Oo _ Ww we SP CO Q (eo) Ww eo] Ny) << uw cO 
© O © © ™s [@>) ™~ - re) Le Li | LJ < 
_ st Et ™ Q ™ m ™ t+ N) oO] CO Li ©O 
1151q ||OSVW 4S4!I4 














Canadian-French Conversion from ASCII to EBCDIC. All digits are hexadecimal. See 


the notes on page G-5. 


Figure G-7. 


Translation for AIX Version 2.1 G-13 


Canadian-French Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII EBCDIC ASCII EBCDIC 
1FA0 B3 1FD2 9D 
1FB4 B6 1FD3 OF 
1FB5 Bd 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 Bg 
1FC4 65 1FD9 BC 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC 77 1FE1 EE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FD0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure G-8. Canadian-French Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for Canadian-French 


Second EBCDIC Digit 





™ Li < mM a aa) Li ™ cS © © ™ Oo 0O ™ 
™ —_ — | cO [0 @] oO ™m ™s <x +t Ww Ww ) 

< ™ o< ice) A MN ™ Li ™ a oO LH M™ oO 

ce = _ © © ©O OQ ‘<e) ™ms LL bs a bs a Ww Ns) 

uw) << .< < © = Ww) uw) Li ice) Ww Ww) LiJ ice) Ww) 
oO Oo — <x <i mM ice) OO ™ ks; a bs a wy) Ns) 

st < < a .<@ Ww < ™ tt st Ww Li. s+ Q Ww + 
— — = — ie @) [9 @) mM Q ice) ™ Oo i st Ww N) 

My) Mv) | <x <x st Li MN) N) © st <x N) © a NM) 
© = = _ © [? @) ea i<e) ice) ~ Li a SS Ww) Ns) 

N ™N N < i<@) NM) 1? @) N ™N ~ Li N mM NM) N 
© —_ — ee © © QO oO ™ aa) st ss uw Nv) 

a Oe ee ee a =| @) et) oO] =|] e] <<] = 
Of ae [= | Kl | el AS oOo}; OK] a;]+] Ff] -—-]|™ 

Oo a= <<  S, © Q CO © Lil aa) Be €5 © 

= Sa = N N N Le LJ wo mn ™~s wy N) 

1161q 91009 4S4l4 














All digits are hexadecimal. See 


-5. 


Figure G-9. Canadian-French Conversion from EBCDIC to ASCII. 
the notes on page G 


G-15 


Translation for AIX Version 2.1 





Danish and Norwegian 


ASCII to EBCDIC Translation for Danish and Norwegian 


al henna meer 5 Second ASCII Digit a ae 


Talal sal es] so] le] ala ele] al 
Fe oo | or] we] os[ sr] wo] 2 [ar [is [os | o | ce | oe [oo] ce or 
| so] s[ofwlwlelal-]-]- 
rafal] «| vr] wf or| ec] so] | @ [elo] | aloo «| a 
mietoter atte refefela fetal lel abe 
/5 [07 | os| os] e2| es] e4| es | e6|e7 | ea | eo | oe | co | oF | SF 6D 
monn ooccicy 
elert ol wl metaal alee el oslo 
NAMM ec cece 
sin tenl wl cle] ele lele lela! 
al ei aisl imate ele 
Pel ar| se] sr] sr sr] oe] oo | oar [ar [ar 
refer of olf bel ole [orl | 
NOMIC cr iceses 
re fen] or| or] w[ me] [| ole lw les ]erle 


Figure G-10. Danish and Norwegian Conversion from ASCII to EBCDIC. All digits are hexadecimal. 
See the notes on page G-5. 




















@)) 
7s 


> 
2 i212 12 if i Ik 
co i fis ee ee 
W |W iiw |W |}WO |}n |W |} wo 
+ nn ini iniIin [m= 1|O |W lw 
mS IS TG > IN [oO }|pA 1 Oo 
SB 1S ics ty > 1 1G iN Te 


Ww |W in [Ww] WD | WoO |Tw Ion |}O }0 
11 [WO IMIN | OPI nIniiIoiito 


First ASCII Digit 
O 


1 | MD |Win ytw }o |W |}o {|O 
Dim im to Tn |osy s+. |W IN 
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Danish and Norwegian Two-Byte Values for ASCII to EBCDIC 


Translation 
ASCII EBCDIC 
1FAO B3 
1FB4 B6 
1FB5 B5 
1FCO 46 
1FC1 59 
1FC2 62 
1FC3 64 
1FC4 65 
1FC5 66 
1FC6 6A 
1FC7 72 
1FC8 73 
1FC9 74 
1FCA 75 
1FCB 76 
1FCC 77 
i1FCD 78 
1FCE 7C 
1FCF 8C 
1FDO 8D 
1FD1 8E 
Figure G-11. 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FEO 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


9D 

5A 

AC 
AD 
AE 
AF 
B9 

BC 
BD 
BE 
BF 
CF 
DA 
EB 
ED 
EE 
EF 
FA 
FB 
FD 
FE 


Danish and Norwegian Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 2.1 G-17 


EBCDIC to ASCII Translation for Danish and Norwegian 


Second EBCDIC Digit 


Hel FFF rll ls lele le] #2 [= 
ejsie/s[=|a]/8/a[a]s/e/8/a/s|) 8/2) 
_tel-[s[el+feletsteie[<{e{e[e] "| + 
er 9109983 a 











All digits are hexadecimal. 


Danish and Norwegian Conversion from EBCDIC to ASCII. 


See the notes on page G-5. 


Figure G-12. 
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English (UK) 


Po 


O 


fetal le 
2 


Second ASCII Digit 


ASCII to EBCDIC Translation for English (UK) 


{151g |IOSV 4S4!4 





English (UK) Conversion from ASCII to EBCDIC. All digits are hexadecimal. See the 


notes. on page G-5. 


Figure G-13. 


Translation for AIX Version 2.1 G-19 





English (UK) Two-Byte Values for ASCII to EBCDIC Translation 


ASCII EBCDIC ASCII EBCDIC 
1FA0 B3 1FD2 9D 
1FB4 B6 1FD3 OF 
1F'B5 Bd 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 Al 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC 77 1FE1 EE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FD0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure G-14. English (UK) Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for English (UK) 


Second EBCDIC Digit 








ep] CTS] CYT oO] eo] eh TNT oe] eT] OTN 
Sipe eat) BR] ae] MT owe me) oo) eT ee 
Wy} Ld | < ct); am; @m;y] wy} ay; mei nN] OF] ub 
a) wee oN FS) PS oe | Oo) OG) ee 


ay 
roe 
ri 

: 

raf eo | 2o| ee] rl or| rs] ro| xe [oe [ra | oe 


r 
rm 








po} 7} 4a] sal ac} ao] se | af | s0| 51 | 52 | 05 | 96 | a: | o7| a5 | 98 


-€| sc} i] ss] se] 55] 56 | 57| 58 | 50 | sa | ro | ez | o9 | €3| co} es 





36 


161g 9109083 hig | 


All digits are hexadecimal. See the 


English (UK) Conversion from EBCDIC to ASCII. 


notes on page G-5. 


Figure G-15. 


Translation for AIX Version 2.1 G-21 





English (US) (ASCII) 


ASCII to EBCDIC Translation for English (US) (ASCII) 


If you requested the ASCII option with the emsend command, the host uses this table to 
translate from ASCII values to EBCDIC values. This table corresponds to information in 
the host’s IND$FILE program. 


Se Second ASCII Digit ar’ i - aaie 


Tees spa ep epee ep el ep r 
ree [ox e2| os | am | ae | ar [v6 [os [as | oo | oc | | | oF 
re fre| apres [xe [we [v2 [ae [se [ve [ar [ar Pie | wo [oe [a 
GOOG OOOO 
[rf re| [ref re [|e | 
Hieiatet wet miaieiteta adtaistats 
rs [or [oe| oof e [es] [es|eeler|@lal mle] «| o| wo 
SOOO Oo CoOooOOooOo 
rf er ae] vf m2 [os me | a Feo-[ 6x [00 | a | 7 
aiatetelaiateieteteis te ataietets 
re [a0 [| taf as | ae a [se [on [se [30 [a [oe [or | ve | ae 
we [sr [se [ss [se [55] oe | 97 
re [se | se] 2[ os] o+| | s6| o7[se [oe | mn | | 5) | 5 
reve 77] mf eo |e] oe | ec | [se [er] oo | o| wo | oo) oo | or 
fof or [vom] a [ae] mar [ao [er] or [es] oe [os] oe | or 
noo SOC ANgeooGoOgoRo 


Figure G-16. English (US) (ASCII) Conversion from ASCII to EBCDIC. All digits are hexadecimal. 
See the notes on page G-5. 














First ASCII Digit 
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EBCDIC to ASCII Translation for English (US) (ASCII) 


If you requested the ASCII option with the emrcev command, the host uses this table to 


translate from EBCDIC values to ASCII values. This table corresponds to information in 


the host’s IND$FILE program. 


Second EBCDIC Digit 


™ Le ~ mo + eo) Loe ™ = ™ O ie 8) Le ™ O 0 @) ™ 
™ co _ © < < Mm O wo ms ™ OQ + te) Ww) *) 
~™ WwW Lid © Le ™ Li © Lie ™ WO 





1161q 910983 arr 


Figure G-17. English (US) (ASCII) Conversion from EBCDIC to ASCII. All digits are hexadecimal. 
See the notes on page G-5. 


Translation for AIX Version 2.1 G-23 





English (US) (TEXT) 


ASCII to EBCDIC Translation for English (US) (TEXT) 


If you requested the TEXT option with the emsend command, the RT PC 3278/79 
Emulation file transfer program uses this table to translate from ASCII values to EBCDIC 
values. 


eS ee eee Second ASCII Digit na 


Toray sf] =] se] [es] [se] fo] 
nDoOoCoED co nogonnong 
rifvol ss] v2] ss | se] wf | [| | afar] fe 

Sf o[a[ wl sl «|| 9[ || [ee «| 
Stef afel al wl e[ | ole fel 
raf vel er] caf es] cel os 
5 07| ps| o| e2| es 























Fc 
| 73| 62| se | 63 | 66 | a | 08 | sr | 43 | aF| oF] oF 
pal ar| oa| 96] sF| 90] oc] a1 | ae | ar | ae | 52 | ar | ae | oF] or] oF 
ps se] se] se] 20] sr] sr] or | ar | ar | ar | or | ae | ae | am] ae] oe 
poof sr] se| se] sr] sr] se] sr} se] sr | sr | sr | ar | sr | ae] sr | oe 


Figure G-18. English (US) (TEXT) Conversion from ASCII to EBCDIC. All digits are hexadecimal. 
See the notes on page G-5. 


First ASCII Digit 


Co 
> 
~ 
uo 
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English (US) (TEXT) Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII EBCDIC 
1FB5 48 
1FDB 55 


Figure G-19. English (US) (TEXT) Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 2.1 G-25 


Emulation file transfer program uses this table to translate from EBCDIC values to ASCII 


If you requested the TEXT option with the emrev command, the RT PC 3278/79 
values. 


EBCDIC to ASCII Translation for English (US) (TEXT) 


Second EBCDIC Digit 














N 


ee 910993 ACE 





All digits are hexadecimal. 


Figure G-20. English (US) (TEXT) Conversion from EBCDIC to ASCII. 
See the notes on page G-5. 
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Finnish and Swedish 


ASCII to EBCDIC Translation for Finnish and Swedish 


Second ASCII Digit 


ae p ayy 
sf | mol ef ale [es fon [oof [eo] of or 














7 
B4 


qs 
mnie 


Eres 


NN Ny ™ O cO Le 
(o>) + uw) ™ aa) ae) 
Oo < WwW Le mM ae) 
<e) ™ ce) cO + ce) Lid 
Wu Ww < NN wo un) © Li 
Lid < ol Oe) &] =} 
Qf, ele | 00 cI; on; wo; 


omc OSV area ood 





co | a5 | 71 | oF | SF | 60 





F 


r 
ES 
90 | eo | es | sr | ra | ea} ae | Fe 


a[-ef co| oe [e [oi for] [elo] 0 











rse| wo] me] ae] ie [we [ar [ar] [+ |] 
=| 7] so] =| m[o|@|s| «| «|| «| o 


5 





F 





pelts 
: 
ite aca 





Finnish and Swedish Conversion from ASCII to EBCDIC. All digits are hexadecimal. 


See the notes on page G-5. 


Figure G-21. 


Translation for AIX Version 2.1 G-27 


Finnish and Swedish Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII EBCDIC ASCII EBCDIC 
1FAO B3 1FD2 9D 
1FB4 B6 1FD3 5A 
1FB5 4A 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 BC 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC 77 1FE1 EE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FD0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure G-22. Finnish and Swedish Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for Finnish and Swedish 


Second EBCDIC Digit 









zs eh ms < + a oe - Sy < i 2 Ps < Oo) 

Ww) ne) 

< ™ < © O ™ ™ LH ™ + <@) Li ™ © 

© _- = ©O co O QO ice) ™ Li + vt wW ne) 

Ww) < < <x © uy) uw) Lid <e) aa) uw) Li Oo Ww 
© © = < < mM <e) © ™ Ww) v+ vt Ww) ‘) 


$16iqg O1d089 +S4!4 








Finnish and Swedish Conversion from EBCDIC to ASCII. All digits are hexadecimal. 


See the notes on page G-5. 


Figure G-23. 


G-29 


Translation for AIX Version 2.1 





French (AZERTY) 


ASCII to EBCDIC Translation for French (AZERTY) 


an oemeaeaeeeenatirans Second ASCII Digit Se 


Tel p 2) 3s] 4] s[ sp pe] | a) 8] ep oe 
foot ool oeoooonneo 
crfre ff alsa] se] | se fae] 
shstetafnt spe elelelsfel «fal el ale 
- Trs| rol 7| rel rol ma) 

“le etstaletetele lela fm[eleL al © 
/ 5 | 07] 08| v9 | ES | E6 EF 

itm atet stat etetetetetetetetet star 
Pr [orf asl sol a2] as[ mos] ne [ar | oe [ as] si | o6] se] eo] a” 
Pace v[ col 2] +3] re| «7| cof so s3| oo] s7| 20] se] os] 
[sist sl Stel sf tele el sts] als ets 
af as [ss] cel oe[ wo] oo [| ce [ee] wr [ on] ool or] 
Pape] orf ar or[ sr] | pela sr] sr a] | eo] oe] or 
rel se [arf sep ar] se] ar] vel oo[ se [or] ef or] 
Pol ccf vf 72] 75] m4] on] v5] v6[ far] ae [ar] sr | oo) 70 
s{afeteletelelalels|n[eiei slot ale: 
rr [cal or[ r[ eo] se] s«[ | of m| mo] oF 


Figure G-24. French (AZERTY) Conversion from ASCII to EBCDIC. All digits are hexadecimal. See 
the notes on page G-5. 













First ASCII Digit 
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French (AZERTY) Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII 


1FA0 
1FB4 
1F'B5 
1FCO 
1FC1 
1FC2 
1FC3 
1FC4 
1FC5 
1FC6 
1FC7 
1FC8 
1FC9 
1FCA 
1FCB 
1FCC 
1FCD 
1FCE 
1FCF 
1FD0 
1FD1 


Figure G-25. 


EBCDIC 


B3 
B6 
5A 
46 
59 
62 
64 
65 
66 
70 
72 
73 
74 
75 
76 
77 
78 
80 
8C 
8D 
8E 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FEO 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


9D 

OF 

AC 
AD 
AE 
AF 
B9 

BC 
Al 

BE 
BF 
CF 
DA 
EB 
ED 
KE 
EF 
FA 
FB 
FD 
FE 


French (AZERTY) Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 2.1 G-31 





EBCDIC to ASCII Translation for French (AZERTY) 


Te i Second EBCDIC Digit ee 


Telap a sy  s] s] 7] e] a] a] eo] of a] 
efeL a a wl fale fl [ll 
TITTY TST 

yt at Bt oh ater ater at alcatel at Stat ore 
a anf sal asl val ol caf tal ef oe | ve oa] a oof onl tal 
abel of sl | 9] sl feel ol ofl =| =| ml ol 
| as] a9| 70| a1| ac| aa| ao| er) r5| 24| 2a| 29| 38) 
eerste ate ataretetetatatalet are 
aT il ool ol os) ol ol el ms | wl anf | ml oe 
al ool st] eal os] ee] | we] orl | we) oe] | ool cl ole 
s[ ee] eo] wl @] wo] el lel] a] a) ol] el ol lo 
ralel al wal al lel al wis] ol el fel ol or 
fs ef al 
82 o| 93| 94] 95] a2| ca | 
tare al at eeetetet a eta dal ate 
Fel ov] val ss] se] o6] so] sr] so] oo] sa] ro] e2| oo] es] col es 
rf sol ar] aa] a5] se] as] sel se] ae] aol rel en] on] eo] esl or 


Figure G-26. French (AZERTY) Conversion from EBCDIC to ASCII. All digits are hexadecimal. See 
the notes on page G-5. 

























First EBCDIC Digit 






- 
D 
F 
F 
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Italian 


ASCII to EBCDIC Translation for Italian 


Second ASCII Digit 





Li Le = Le ™ ™ + mM Le Li Li Lij Cs. 
oO Ke) ce) O <e) mM co ™) 12>) ae) aa) Le 


ere OSV ee ae 





Italian Conversion from ASCII to EBCDIC. All digits are hexadecimal. See the notes on 


Figure G-27. 


page G-5. 


Translation for AIX Version 2.1 G-33 


Italian Two-Byte Values for ASCII to EBCDIC Translation 


ASCII EBCDIC ASCII EBCDIC 
1FA0 B3 1FD2 9D 
1FB4 B6 1FD3 OF 
1FB5 7C 1FD4 AC 
1FCO 46 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 BC 
1FC5 66 1FDA BD 
1FC6 70 1FDB BE 
1FC7 72 1FDC BF 
1FC8 73 1FDD CF 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC Tt 1FE1 EE 
1FCD 78 1FE2 EF 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1F D0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure G-28. Italian Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for Italian 


sco BBCI Digi 


Tea 2ts-[s[e[7[*]*]*[e,e) op ef 
ro [00 [or | cz] os | im] ov | on |r| || on | | 0 | | oF | oF 
im fon [os [rm fre [ro [mm tm | va] va] 10 
re fim [om [ral tm | ta] on [ir [ve [om [em | im [om | om | os] os | 07 
fel fw few i [off De le 
7 
Hfefelwtetefetolelatetetsts lel sl 
[se [so | v2 [os [o« fos [or [oe foe [or | |ec | rs | 27] | a2 
NASA ee Ss Sacer 
To [so |en| eo] cleo] olor [m[n|m[a[m|o |r| 

res [eo] 7s | 75| [7 [|r || m [a] o || co] a9 
[eo | 2s se[ ra lor| ales [ac [mm [ra[m| | ce] ro] er] ve 
Poo fae ee 
m[eol ee ]wo [ae [ar [oo [er |e [os | 05 [or] oo] as oo 
rss [ se [ss] so | s7 [oe [se | sa | ro [e2| oo] es] co] cs 
[se [a7 [se [se [ro [ex] on [es] eo | rr 


Figure G-29. Italian Conversion from EBCDIC to ASCII. All digits are hexadecimal. See the notes on 
page G-5. 


















OO 
NO 
NO 





> 
mM 
na 
— 
© 
mM 
a) 


First EBCDIC Digit 





a 
<e) ~N 
m }m | oO 
m1 | GC | NY 

me FD 
N 7 


Co 
> 
No 


© |o 
= | 
> 
W 









mM 
O 





Oo 
WG — | 


Translation for AIX Version 2.1 G-35 


ASCII to EBCDIC Translation for Japanese English 


Japanese English 


Second ASCII Digit 


Japanese English Conversion from ASCII to EBCDIC. All digits are hexadecimal. See 


the notes on page G-5. 





SR OSV a oo 
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Figure G-30. 


Japanese English Two-Byte Values for ASCII to EBCDIC 
Translation 


ASCII 


1FA0 
1FB4 
1FB5 
1FCO 
1FC1 
1FC2 
1FC3 
1FC4 
1FC5 
1FC6 
1FC7 
1FC8 
1FC9 
1FCA 
1FCB 
1FCC 
1FCD 
1FCE 
1FCF 
1FD0 
1FD1 


Figure G-31. 


EBCDIC 


B3 
B6 
B5 
46 
59 
62 
64 
65 
66 
70 
72 
73 
74 
75 
76 
77 
78 
80 
8C 
8D 
8E 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FEO 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


9D 

9F 

AC 
AD 
AE 
AF 
B9 

Al 

BD 
BE 
BF 
CF 
DA 
EB 
ED 
EE 
EF 
FA 
FB 
FD 
FE 


Japanese English Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 2.1 G-37 





EBCDIC to ASCII Translation for Japanese English 


Second EBCDIC Digit [aT a 


he 
Tela ast] se] 7] eo] so] o] of ef 
shel a] wl el al wl el wl wf al ml el ol wl | oe 
fool if el asl val of of oe wo of al oa ol al oe 
rs a] a aS) ot el pe) abel all elt al © 
Ps Pia) tal a6) 0 Evy 
stale elt afew bel el al taf ele 
| al oe 

steteterstetetoetetetel =| alsl ste 
az} oo} wo] ca] o5] o+| vel or] vel mc] oo] onl as| ol 
sl mba ef el Wl lal whale al ol oe el el 
[ra] onl sal ccf ool ee| er[ 70[ 7] v2 06] a7] | er] col or 
7 
peteol ol ef eof eel of fell fel ol ol of ol 
elon] aol tol ol cota er lae 
alm] wl of ol ol cel ol wl of oll wl wt el sal a 
ref ze] sal as] s+| s6| 56] 7 se] so! sa] eo] e2| so] 3] co] co 


Figure G-32. Japanese English Conversion from EBCDIC to ASCII. All digits are hexadecimal. See 
the notes on page G-5. 












— 


WG 















First EBCDIC Digit 
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Portuguese 





Lu Li i LL ™ ™ + ea Lo Li Li. Li 
Li) Lid aa) Lil Ww Li WwW 0O w) Le < N Li cO © Le 
© + © Q uw) oO t+ Co) ‘) co aa) ‘) ™ aa) “= 
Lil vt < t+ Li 06) < Li Li Q < 
~ © Ww) Oo aa) Ww) < NM) O < Li} 
©O O O ‘) 
© + a) 
™ LiJ LiJ N 
< < Li O < < Li LL Li aa) “) 
© ~) WwW ™ mM m ™) “) La. mM 
uy Oo Q O Li Li Lie Lie LiJ 
© - te) Le < ad) ~) ne) Li 





96 





ADO Ie 


: 
E6 


Second ASCII Digit 


| so el | ml os os [|| | 


‘Tol a af al al a o 


a alk 


$151g |JOSV 4S4l4 


mf of el ool sf oof of fo [orf wo 


ASCIT to EBCDIC Translation for Portuguese 





Figure G-33. Portuguese Conversion from ASCII to EBCDIC. All digits are hexadecimal. See the 


notes on page G-5. 


G-39 


Translation for AIX Version 2.1 


Portuguese Two-Byte Values for ASCII to EBCDIC Translation 


ASCII EBCDIC ASCII EBCDIC 
1FAO B3 1FD2 9D 
1F'B4 B6 1FD3 OF 
1F'B5 B5 1FD4 AC 
1FCO CO 1FD5 AD 
1FC1 59 1FD6 AE 
1FC2 62 1FD7 AF 
1FC3 64 1FD8 B9 
1FC4 65 1FD9 BC 
1FC5 7B 1FDA BD 
1FC6 70 1FDB DO 
1FC7 72 1FDC BF 
1FC8 73 1FDD 6A 
1FC9 74 1FDE DA 
1FCA 75 1FDF EB 
1FCB 76 1FEO ED 
1FCC ver 1FE1 EE 
1FCD 78 1FE2 7C 
1FCE 80 1FE3 FA 
1FCF 8C 1FE4 FB 
1FD0 8D 1FE5 FD 
1FD1 8E 1FE6 FE 


Figure G-34. Portuguese Two-Byte Values for ASCII to EBCDIC Translation 
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EBCDIC to ASCII Translation for Portuguese 


Second EBCDIC Digit 








Lb} wml ntl —|] ml olan 
wT Mm | NW) ke | Oy ee OU 


[efor 


fale to fofe lo [el cof a 


eee 910993 ae ee 


Portuguese Conversion from EBCDIC to ASCII. 


notes on page G-5. 





All digits are hexadecimal. See the 


Figure G-35. 


Translation for AIX Version 2.1 G-41 





Spanish 
ASCII to EBCDIC Translation for Spanish 


Second ASCII Digit 
eneendene 


Tet sT af sf ssf of oT al of 
re] oof or] el os] v7| 20] ze] ar] v6 o 
refief aif af is] vf v0 [ae | 26 |e | vo 
pfelel Tel el ef el ef ef els 
erate etaeatect mat at a! Poel 
|| o7| ve] oo] ez] es) e4| e5| c6| e7 | ca alata a 
rel 70] x] eel os] oe] co] oo] ov | oo | w» sf oe) ool an) 
a] ar] ee) oo) sa] a] ae] os] 08 | | ow Inne 
Pal oe] cel sr] a2] as) | «| we] sa] os] s| sr] oe] sl esl 
paf nf oe nel fel of oof volar PeeT ref mf m fal oro 
pas ss] oe| ce | onl re on | oe] oe | or 

xf se[ orl oF] oe[ e5| oe] or | or 
rel ae] sel orl ar] ae] oe | ao] ool or bor 
Pol se] vel rel va] m4] on] | ve] oe | or 
of wf wf el we 
Creal er| orl eo] 6] ee | se] oof v0 | a | os 


Figure G-36. Spanish Conversion from ASCII to EBCDIC. All digits are hexadecimal. See the notes 
on page G-5. 









mM 

™S 

m™m 
© 
WG 
© 
7 










N 
Co 


QO }o 
oO }N 
es 


> 
> 


8) 

> 

7 
Sin Sa SiS Is ls ie is if eis 
Onin nDnINIo jf} |oO f[- |o 


00 


First ASCII Digit 
NO 
a 


= 
mM 
O 


Ww 
a 
WG 


~S 
WG 
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Spanish Two-Byte Values for ASCII to EBCDIC Translation 


ASCII EBCDIC 
1FAO0 B38 
1FB4 B6 
1FB5 B5 
1FCO 46 
1FC1 59 
1FC2 62 
1FC3 64 
1FC4 65 
1FC5 66 
1FC6 70 
1FC7 72 
1FC8 73 
1FC9 74 
1FCA 75 
1FCB 76 
1FCC ry! 
1FCD 78 
1FCE 80 
1FCF 8C 
1FDO 8D 
1FD1 8E 
Figure G-37. 


ASCII 


1FD2 
1FD3 
1FD4 
1FD5 
1FD6 
1FD7 
1FD8 
1FD9 
1FDA 
1FDB 
1FDC 
1FDD 
1FDE 
1FDF 
1FEO 
1FE1 
1FE2 
1FE3 
1FE4 
1FE5 
1FE6 


EBCDIC 


9D 

OF 

AC 
AD 
AE 
AF 
B9 

BC 
Al 

BE 
BF 
CF 
DA 
EB 
ED 
EE 
EF 
FA 
FB 
FD 
FE 


Spanish Two-Byte Values for ASCII to EBCDIC Translation 


Translation for AIX Version 2.1 G-43 





EBCDIC to ASCII Translation for Spanish 





pape irciolres Second EBCDIC Digit 






fiefs a c | 0 | 

1A | on 
RRP Ei ies 08 ae 
ps {ra} wa} se] ta] a] ta | ta | on 14 | is 
4 | 20 | 1a | os] a | 05 | 0 | c6 | a6 | 87 | 00 | se | 2e | 3c | 28] 20 | 70 
s | 26 | 82| 88 | a9 | aa| at | ac | ae | eo | er | so | 24 | 2a | 29| 30 | AA 
6 | 2 | ar | a6 | ee | 87 | a5 | c7 | oF | oo | 25 | a4 | 20 | 25 | oF | 3e| 3 
7 | 98 | 90 | 02] 03 | o4| 96 | 07 | os | ve | 60 | 3a | as | 40 | 27] 30 | 
AAT Se oc acai Ft 
}o | re | oa} oa} sc | oo} oe | oF | 70 | 7 | 72 | a6 | a7 | 91 | F7| o2| oF 
74 77 | 78 | 79 | 7 | ao | a8 | 01 | c0| c8| Ao 
fm se ne a ae are z 
Le | 43 a7 | a8 | 4s 
fo | 70 | | 43} 40 | 40 | SAAC 
Lpep ess sibel sola ele 
+ | 30] a1] 32] 35 | 34] 35 | 36 | 37_ co | er | 


Figure G-38. Spanish Conversion from EBCDIC to ASCII. All digits are hexadecimal. See the notes 
on page G-5. 


















First EBCDIC Digit 
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The following definitions are applicable to 
IBM RT PC 3278/79 Emulation. 


adapter. An attachment that modifies a 
mechanism to operate in a particular way. 
Often referred to as an adapter card. 


append. The action that adds data to the 
end of existing data. 


ASCII. American Standard Code for 
Information Interchange. A standard code 
used for exchanging information among 
data processing systems and associated 
equipment. 


Attn. A function key that operates only 
when a B is displayed in the Readiness 
and System Connection section of the 
Operator Information Area. This key lets 
you get the attention of the program. 


byte. A character of information. Eight 
bits. 


CECP. Country-extended code page. A 
chart of characters and their numeric 
equivalents, used in file transfer for 
specific national languages. 


Clear. Function key that erases the 
display and signals the host that a clear 
action has occurred. 


Glossary 


Click. Function key that turns the 
keyboard clicker on and off. Defined for 
IBM RT PC 3278/79 Emulation but not 
implemented. 


control unit. A device that controls the 
input/output operations at one or more 
devices. 


CP. Code page. A chart of characters 
and their numeric equivalents, used in file 
transfer. 


Cursor Select. Function key that selects 
a selectable field for processing. 


default. A value or option that is 
assumed when none has been specified. 


device driver. A program that operates a 
specific device, such as a printer, disk 
drive, or display. 


Dev Cncl. Function key that cancels a 
pending print request. 


display. An output device used for the 
visual display of data. 


Dup. Function key that sends a request 
for a duplication operation to the 
program. This operation is defined by the 
program and lets you fill in information 
that is the same for every document. For 


Glossary X-1 





example, the date could be duplicated on a 
series of documents. 


EBCDIC. Extended Binary Coded 
Decimal Interchange Code. A coded 
character set consisting of 8-bit coded 
characters. The standard code used by 
IBM 370 computers. 


Erase Input. Function key that erases 
all input fields and moves the cursor to 

the first input character position on the 
screen. 


Erase EOF. Function key that erases 
the input field from the cursor to the end 
of the field. The cursor does not move. 


field. A specified area used for a 
particular category of data. 


field attribute. A property or 
characteristic of a data field as displayed 
on the screen, such as color or 
highlighting. 


file transfer. The function that lets you 
send and receive files between an IBM RT 
PC and a host. 


Field Mark. Function key that indicates 
the end of a field in an unformatted 
display. 


hardware. The physical equipment used 
in data processing, as opposed to 
programs, procedures, and associated 
documentation (software). 


host computer. A large, central 
computer which provides services such as 
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computation, data base access, special 
programs, or programming languages. 


Ident. Function key that identifies the 
next two numbers as the printer ID code. 
The ID is displayed in the Operator 
Information Area. If your printer 
assignment is changed, use the IDENT key 
to display the new ID. 


interrupt. (1) To take an action ata 
receiving station that causes the sending 
station to end a transmission. (2) A signal 
sent by an I/O device to the processor 
when an error has occurred or when 
assistance is needed to complete I/O. An 
interrupt usually suspends execution of 
the currently executing program. 


logging on. The procedure by which you 
are linked to a multiple-user host 
computer. The procedure requires a user 
identification and a password. 


mnemonic. Characters used to represent 
a more difficult character or phrase. A 
memory aid. 


none. Key definition that removes the 
assignment for a key or key combination 
in the profile. 


operator information area. In the 3270 
Information Display System, the area near 
the bottom of the display where you 
receive information about the status of 
your terminal or system. 


PA1, PA2, PA3. Program access function 
keys that communicate with a program. 





PF1...PF24. Program function keys 
assigned application functions. 


parameter. An argument passed to a 
procedure. 


power-on reset. Function equivalent to 
turning on the power to the IBM 3278/79 
display or switching the normal/test 
toggle switch to normal. 


Print. Function key that sends data from 
the display station to the selected host 
printer. 


problem determination. The process of 
identifying why the system is not working. 
Often this process identifies programs, 
equipment, data communications facilities, 
or user errors as the source of the 
problem. 


protected field. An area containing data 
that you cannot change. 


shell script. A program that accepts and 
interprets commands for the operating 
system. 


software. Programs that pertain to the 
operation of a computer system. 


stdin. The primary source of data going 
into a command. Standard input comes 
from the keyboard unless redirection or 
piping is used, in which case standard 


input can be from a file or the output from 
another command. 


stdout. The primary destination of data 
coming from a command. Standard output 
goes to the display unless redirection or 
piping occurs, in which case standard 
output can be to a file or another 
command. 


superuser authority. The unrestricted 
ability to access and modify any part of 
the operating system associated with the 
user who manages the system. 


Sys Req. If an A appears in the 
Readiness and System Connection section 
of the Operator Information Area when a 
display failure is pending, this function 
key signals a test request message. 


If a B appears in the Readiness and 
System Connection section of the Operator 
Information Area, the key can clear the 
display or switch the display between an 
application and the control program. 


Test. Function key that runs special 
problem determination functions. Refer to 
your display station’s Problem 
Determination Guide. 


virtual resource manager (VRM). A 
set of programs that manage the hardware 
resources (main storage, disk storage, 
display stations, and printers) of the 
system so that these resources can be used 
independently of each other. 
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